Installation on Apache

This guide will walk you through installing Nexora on a server running Apache web server.

---

Table of Contents

1. Prerequisites
2. Step 1: Server Preparation
3. Step 2: Install PHP and Extensions
4. Step 3: Install Composer and Node.js
5. Step 4: Create Database
6. Step 5: Upload Files
7. Step 6: Configure Apache
8. Step 7: Enable mod_rewrite
9. Step 8: Set Permissions
10. Step 9: Run the Installer
11. Step 10: Post-Installation
12. Troubleshooting

---

Prerequisites

Before starting, ensure you have:

• ✅ Root or sudo access to server
• ✅ Apache installed and running
• ✅ PHP 8.2+ installed
• ✅ MySQL/PostgreSQL database server
• ✅ Domain or IP address configured
• ✅ Reviewed System Requirements

---

Step 1: Server Preparation

Update System Packages

Ubuntu/Debian:

sudo apt update
sudo apt upgrade -y

CentOS/RHEL:

sudo yum update -y

Install Required Tools

Ubuntu/Debian:

sudo apt install -y curl wget git unzip

CentOS/RHEL:

sudo yum install -y curl wget git unzip

---

Step 2: Install PHP and Extensions

Install PHP 8.2+

Ubuntu 22.04+:

sudo apt install -y php8.2 libapache2-mod-php8.2 php8.2-cli

Ubuntu 20.04:

sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install -y php8.2 libapache2-mod-php8.2 php8.2-cli

CentOS/RHEL:

sudo yum install -y epel-release
sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
sudo yum module reset php
sudo yum module enable php:remi-8.2
sudo yum install -y php php-cli

Install Required PHP Extensions

Ubuntu/Debian:

sudo apt install -y \
    php8.2-mysql \
    php8.2-pgsql \
    php8.2-sqlite3 \
    php8.2-mbstring \
    php8.2-xml \
    php8.2-curl \
    php8.2-intl \
    php8.2-zip \
    php8.2-gd \
    php8.2-bcmath

CentOS/RHEL:

sudo yum install -y \
    php-mysqlnd \
    php-pgsql \
    php-sqlite3 \
    php-mbstring \
    php-xml \
    php-curl \
    php-intl \
    php-zip \
    php-gd \
    php-bcmath

Verify PHP Installation

php -v
# Should show PHP 8.2.0 or higher

php -m
# Should show all required extensions

Configure PHP

Edit php.ini:

sudo nano /etc/php/8.2/apache2/php.ini
# or for CentOS: sudo nano /etc/php.ini

Update these settings:

memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
date.timezone = America/New_York  # Set your timezone

---

Step 3: Install Composer and Node.js

Install Composer

cd /tmp
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer
composer --version

Install Node.js and NPM

Using NodeSource:

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

Verify:

node --version
npm --version

---

Step 4: Create Database

MySQL/MariaDB

Login to MySQL:

sudo mysql -u root -p

Create Database and User:

CREATE DATABASE cms_multipurpose_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'cms_multipurpose_user'@'localhost' IDENTIFIED BY 'strong_password_here';
GRANT ALL PRIVILEGES ON cms_multipurpose_db.* TO 'cms_multipurpose_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

---

Step 5: Upload Files

Option A: Using Git

cd /var/www/html
sudo git clone [your-repository-url] cms_multiple
cd cms_multiple

Option B: Using SCP/SFTP

Upload files to /var/www/html/cms_multiple or your web root directory.

Set Ownership

sudo chown -R www-data:www-data /var/www/html/cms_multiple
# or for CentOS: sudo chown -R apache:apache /var/www/html/cms_multiple

---

Step 6: Configure Apache

Create Virtual Host

Ubuntu/Debian:

sudo nano /etc/apache2/sites-available/cms_multiple.conf

CentOS/RHEL:

sudo nano /etc/httpd/conf.d/cms_multiple.conf

Virtual Host Configuration

Add the following:

<VirtualHost *:80>
    ServerName yourdomain.com
    ServerAlias www.yourdomain.com
    DocumentRoot /var/www/html/cms_multiple/public

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

    ErrorLog ${APACHE_LOG_DIR}/cms_multiple_error.log
    CustomLog ${APACHE_LOG_DIR}/cms_multiple_access.log combined
</VirtualHost>

Important: Replace yourdomain.com and path with your actual values.

Enable Site

Ubuntu/Debian:

sudo a2ensite cms_multiple.conf
sudo systemctl reload apache2

CentOS/RHEL:

sudo systemctl reload httpd

---

Step 7: Enable mod_rewrite

Check if Enabled

Ubuntu/Debian:

apache2ctl -M | grep rewrite

CentOS/RHEL:

httpd -M | grep rewrite

Enable mod_rewrite

Ubuntu/Debian:

sudo a2enmod rewrite
sudo systemctl restart apache2

CentOS/RHEL:

# Usually enabled by default
# If not, edit /etc/httpd/conf/httpd.conf and uncomment:
# LoadModule rewrite_module modules/mod_rewrite.so
sudo systemctl restart httpd

Verify .htaccess Support

Ensure your virtual host allows .htaccess overrides:

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

---

Step 8: Set Permissions

Set Directory Permissions

cd /var/www/html/cms_multiple
sudo chown -R www-data:www-data .
# or for CentOS: sudo chown -R apache:apache .
sudo find . -type d -exec chmod 755 {} \;
sudo find . -type f -exec chmod 644 {} \;

Set Writable Directories

sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache
# or for CentOS: sudo chown -R apache:apache storage bootstrap/cache

Set Executable Files

sudo chmod +x artisan

---

Step 9: Run the Installer

Access the Installer

1. Open browser
2. Navigate to: http://yourdomain.com/install
3. Or: http://your-server-ip/install

Follow Installer Steps

See Web Installer Guide for detailed steps.

---

Step 10: Post-Installation

Install Dependencies (if needed)

cd /var/www/html/cms_multiple
composer install --no-dev --optimize-autoloader
npm install
npm run build

Set Up SSL (Let's Encrypt)

Install Certbot:

sudo apt install -y certbot python3-certbot-apache

Obtain Certificate:

sudo certbot --apache -d yourdomain.com -d www.yourdomain.com

Auto-Renewal:

sudo certbot renew --dry-run

Configure Cron Jobs

Edit crontab:

sudo crontab -e -u www-data
# or for CentOS: sudo crontab -e -u apache

Add:

* * * * * cd /var/www/html/cms_multiple && php artisan schedule:run >> /dev/null 2>&1

Set Up Queue Worker

See Post-Installation Setup for queue worker configuration.

---

Troubleshooting

500 Internal Server Error

Solutions:

1. Check Apache error log:

   sudo tail -f /var/log/apache2/error.log
   # or for CentOS: sudo tail -f /var/log/httpd/error_log
   

2. Verify .htaccess exists in public/ directory

3. Check mod_rewrite is enabled

4. Verify file permissions

mod_rewrite Not Working

Solutions:

1. Enable mod_rewrite:

   sudo a2enmod rewrite
   sudo systemctl restart apache2
   

2. Check AllowOverride is set to "All"

3. Verify .htaccess file exists

4. Check Apache configuration

Permission Denied

Solutions:

1. Check file ownership:

   ls -la /var/www/html/cms_multiple
   

2. Fix ownership:

   sudo chown -R www-data:www-data /var/www/html/cms_multiple
   

3. Fix permissions:

   sudo chmod -R 755 /var/www/html/cms_multiple
   sudo chmod -R 775 storage bootstrap/cache
   

---

Next Steps

1. Review Post-Installation Setup
2. Configure General Settings
3. Read Getting Started Guide

---

Last Updated: [Date will be updated during final review]