Installing AcelleMail on Ubuntu 22.04

Prerequisites#

• Ubuntu 22.04 LTS server (2GB RAM minimum)
• Root or sudo access
• Domain name pointed to server IP

Step 1: Install PHP 8.3#

sudo apt update && sudo apt upgrade -y
sudo add-apt-repository ppa:ondrej/php -y
sudo apt install php8.3 php8.3-fpm php8.3-mysql php8.3-mbstring \
  php8.3-xml php8.3-curl php8.3-zip php8.3-gd php8.3-intl \
  php8.3-bcmath php8.3-redis -y

Step 2: Install MySQL 8.0#

sudo apt install mysql-server -y
sudo mysql_secure_installation

# Create database
sudo mysql -e "CREATE DATABASE acellemail CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
sudo mysql -e "CREATE USER 'acellemail'@'localhost' IDENTIFIED BY 'your_password';"
sudo mysql -e "GRANT ALL ON acellemail.* TO 'acellemail'@'localhost';"

Step 3: Install Composer#

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Step 4: Install Nginx#

sudo apt install nginx -y

Step 5: Upload AcelleMail#

cd /var/www
# Upload your AcelleMail files here
sudo chown -R www-data:www-data /var/www/acellemail

Step 6: Configure Nginx#

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/acellemail/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

Step 7: Install Dependencies#

cd /var/www/acellemail
composer install --no-dev --optimize-autoloader
cp .env.example .env
php artisan key:generate

Step 8: Configure Environment#

Edit .env with your database credentials and domain.

Step 9: Run Installer#

Visit https://yourdomain.com/install in your browser and follow the web installer.

Step 10: Set Up Cron & Queue#

# Cron (run every minute)
echo "* * * * * www-data cd /var/www/acellemail && php artisan schedule:run >> /dev/null 2>&1" | sudo tee /etc/cron.d/acellemail

# SSL with Let's Encrypt
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d yourdomain.com