How to Install ACP Admin on Debian Latest

ACP Admin is an open source web-based administration panel built on PHP and Laravel. It allows you to manage your servers, websites, domains, FTP accounts, and more. This tutorial will guide you through the installation process of ACP Admin on Debian Latest.

Requirements

Before you start, make sure your Debian server meets the following requirements:

• Apache or Nginx web server
• PHP 7.2 or higher
• MySQL or MariaDB database server
• GIT

Step 1 - Install Dependencies

First, update the apt package manager and install required packages:

sudo apt update
sudo apt install curl git nano zip unzip wget software-properties-common apt-transport-https gnupg2 ca-certificates lsb-release

Step 2 - Install Apache and PHP

Next, install Apache and PHP along with required PHP modules:

sudo apt install apache2 libapache2-mod-php php php-common php-mysql php-redis php-mbstring php-intl php-gd php-xml php-zip php-curl php-xmlrpc php-soap php-bcmath php-pear php-dev -y

Step 3 - Install MySQL

Install MySQL or MariaDB database server:

sudo apt install mariadb-server mariadb-client -y

Then, secure the MySQL by running:

sudo mysql_secure_installation

Step 4 - Install Composer

Navigate to the official Composer website and copy the installation command:

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

Then, verify the Composer installation by running:

composer --version

Step 5 - Clone ACP Admin Repository

Navigate to the /var/www directory and clone acp-admin repository:

cd /var/www
sudo git clone https://github.com/youkoso/acp-admin.git

Step 6 - Configure the Database

Create a new database for ACP Admin and grant permissions to a new user:

sudo mysql -u root -p

Enter your MySQL root password and run the following commands:

CREATE DATABASE acpadmin CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL ON acpadmin.* TO 'acpadmin'@'localhost' IDENTIFIED BY 'NewStrongPass27';
FLUSH PRIVILEGES;
EXIT

Step 7 - Configure the Web Server

Configure Apache to serve the ACP Admin website:

sudo nano /etc/apache2/sites-available/acp-admin.conf

Add the following configuration:

<VirtualHost *:80>
  ServerAdmin webmaster@localhost
  DocumentRoot /var/www/acp-admin/public
  <Directory /var/www/acp-admin>
      Options Indexes FollowSymLinks MultiViews
      AllowOverride All
      Order allow,deny
      allow from all
  </Directory>

  ErrorLog ${APACHE_LOG_DIR}/acp-admin-error.log
  CustomLog ${APACHE_LOG_DIR}/acp-admin-access.log combined
</VirtualHost>

Then, enable the new virtual host and reload Apache:

sudo a2ensite acp-admin.conf
sudo systemctl reload apache2

Step 8- Configure ACP Admin

Navigate to the ACP Admin directory and install dependencies using Composer:

cd /var/www/acp-admin
sudo composer install

Configure .env file:

sudo cp .env.example .env
sudo nano .env

Update the following variables to match your server configuration:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=acpadmin
DB_USERNAME=acpadmin
DB_PASSWORD=NewStrongPass27

Generate an application key:

sudo php artisan key:generate

Finally, run the database migrations:

sudo php artisan migrate --seed

Step 9 - Access ACP Admin

ACP Admin should now be accessible via your web browser at http://your_server_ip. Use the following credentials to login:

Username: [email protected]
Password: admin

Conclusion

Congratulations! You have successfully installed ACP Admin on your Debian Latest server. You can now manage your servers and websites with ease.