Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/gavafue/registroComponentesMultimedia/llms.txt

Use this file to discover all available pages before exploring further.

The ISBO Registro de Equipamiento Multimedia is a PHP/MySQL web application that runs on any standard Apache + PHP stack. This guide walks you through preparing a server or local machine to host the application, covering both a production CentOS 9 / RHEL environment and a XAMPP-based local development setup.

​
Supported Environments

EnvironmentUse caseDocument root
CentOS 9 / RHEL (Apache)Production server/var/www/html
XAMPP on WindowsLocal development / demosC:\xampp\htdocs
XAMPP on LinuxLocal development/opt/lampp/htdocs
If you only need a quick local demo on Windows, skip the CentOS steps and jump straight to the XAMPP section below. XAMPP bundles Apache, PHP, and MariaDB in a single installer — no manual service configuration required.

​
Production Setup: CentOS 9 / RHEL

1

Install Apache, PHP, and MySQL (MariaDB)

Log in as root or a user with sudo privileges, then install all required packages in a single command:
sudo dnf install httpd php php-pdo php-mysqlnd mariadb-server -y
This installs:
  • httpd — the Apache HTTP server
  • php — the PHP interpreter
  • php-pdo — PHP’s database abstraction layer (required by the API)
  • php-mysqlnd — the native MySQL driver for PDO
  • mariadb-server — MariaDB (fully compatible with MySQL syntax used by the app)
2

Start and Enable Services

Enable both Apache and MySQL so they start automatically on every boot, and start them immediately:
sudo systemctl enable --now httpd
sudo systemctl enable --now mariadb
Verify both services are running:
sudo systemctl status httpd
sudo systemctl status mariadb
Both should report active (running).
3

Copy Application Files

Copy (or clone) the project into the Apache document root:
sudo cp -r /path/to/registroComponentesMultimedia/* /var/www/html/
After copying, your document root should contain at minimum:
/var/www/html/
├── api/
│   ├── config.php
│   ├── auth.php
│   ├── loans.php
│   ├── fix_auth.sh
│   └── sesiones/
├── assets/
└── index.html
The api/sesiones/ directory stores PHP session files. If it does not exist yet, create it before starting the app:
sudo mkdir -p /var/www/html/api/sesiones
File permissions for this directory are covered in the Permissions guide.
4

Configure the Apache Virtual Host (Optional)

For a production server with a domain name, create a virtual host configuration file at /etc/httpd/conf.d/isbo.conf:
sudo nano /etc/httpd/conf.d/isbo.conf
Minimal virtual host configuration:
<VirtualHost *:80>
    ServerName your-domain-or-ip
    DocumentRoot /var/www/html

    <Directory /var/www/html>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog  /var/log/httpd/isbo_error.log
    CustomLog /var/log/httpd/isbo_access.log combined
</VirtualHost>
Reload Apache to apply the change:
sudo systemctl reload httpd
5

Open the Firewall for HTTP Traffic

CentOS 9 ships with firewalld enabled by default. Open port 80 permanently and reload the firewall rules:
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --reload
If your server also serves HTTPS (port 443), add it as well:
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload
6

Verify the Installation

Open a browser and navigate to your server’s IP address or domain name:
http://<server-ip>/
You should see the ISBO equipment registry login or home page. If you see the Apache default welcome page instead, either the files were not copied correctly or the virtual host configuration needs a reload.

​
XAMPP — Local Development

XAMPP provides a self-contained development environment that requires no system-level service management. It is the fastest way to run the application locally on Windows or Linux.
1

Download and Install XAMPP

Download the XAMPP installer for your platform from apachefriends.org and run the installer. During setup, ensure Apache, MySQL, and PHP components are selected.Default install locations:
PlatformPath
WindowsC:\xampp
Linux/opt/lampp
2

Start Apache and MySQL

Open the XAMPP Control Panel (Windows) or run the manager from /opt/lampp (Linux), then click Start next to both Apache and MySQL.On Linux you can also use the command line:
sudo /opt/lampp/lampp start
3

Copy Application Files to htdocs

Place the project in the XAMPP document root:
Copy-Item -Recurse .\registroComponentesMultimedia\* C:\xampp\htdocs\isbo\
The app will then be available at:
http://localhost/isbo/
4

Verify in Browser

Open http://localhost/isbo/ in your browser. If the page loads, the server environment is ready. Proceed to the Database setup guide to create the schema.
On Windows, XAMPP does not use SELinux or firewalld, so you can skip the firewall and permissions steps that apply only to CentOS. The fix_auth.sh script is not needed for XAMPP; see the Permissions guide for manual XAMPP-specific steps.

Build docs developers (and LLMs) love

Get started for freeTalk to us