Installation Guide
GeniXCMS is designed for a friction-less deployment experience. Follow this structured guide to get your CMS up and running in minutes.
🏗️ System Requirements
Before you begin, ensure your server environment meets the following specifications:
⚙️ Minimal Stack
- PHP Engine: 8.1 or higher (Recommended: 8.3)
- Database: MySQL 5.7+, MariaDB 10.3+, SQLite3, or PostgreSQL
- Extensions:
pdo, mbstring, json, gd, zip, xml
🌐 Web Servers
- Nginx (Recommended) with PHP-FPM
- Apache with
mod_rewrite enabled
- Litespeed
📂 Step 1: Uploading Files
The process is identical regardless of your hosting provider (Shared, VPS, or Dedicated).
- Transfer Files: Upload the GeniXCMS package to your webserver root (e.g.,
public_html or /var/www/html) using FTP, SFTP, or your Control Panel's File Manager.
- Permissions: Ensure the following directories are writable (chmod
775 or 777 depending on your server configuration):
inc/config/ (Required for generating config.php)
assets/images/
assets/media/
assets/cache/ (If applicable)
🗄️ Step 2: Preparing the Database
GeniXCMS requires a database to store your content and configurations.
- Create Database: Access your Database Manager (e.g., phpMyAdmin, cPanel MySQL Wizard).
- Assign User: Create a new database user and assign them to the database with ALL PRIVILEGES.
- Note Credentials: Keep the following information ready for the installation wizard:
- Database Name
- Database Username
- Database Password
- Database Host (usually
localhost)
🚀 Step 3: Running the Wizard
To launch the automated installation:
- Navigate: Open your website URL in any modern browser.
- Wizard: You will be automatically redirected to the Installation Wizard.
- Config: Fill in the Database details and Site information as prompted.
- Finish: Follow the steps until the "Installation Complete" message appears.
🔑 Step 4: Accessing the Dashboard
Once finished, navigate to the administration area to begin building your site:
- Dashboard URL:
https://yourdomain.com/gxadmin/
- Authentication: Use the Username and Password you defined during the installation process.
warningCautionSecurity Tip: After a successful installation, it is highly recommended to change the permissions of inc/config/config.php to Read-Only (chmod 444 or 644) to protect your database credentials.