How to Install ViMbAdmin on Manjaro

ViMbAdmin is a web-based application designed to manage virtual mail domains and mailboxes hosted on a Postfix / Dovecot setup. In this tutorial, we will guide you through the process of installing ViMbAdmin on Manjaro.

Step 1: Update Your System

Before we begin, ensure that your system is up to date by running the following command:

sudo pacman -Syu

Step 2: Install Required Dependencies

ViMbAdmin relies on several PHP packages to function correctly. To install all the necessary dependencies, run the following command in your terminal:

sudo pacman -S php php-apache mariadb postfix dovecot

Step 3: Download ViMbAdmin

Next, visit the official ViMbAdmin website at https://www.vimbadmin.net/ and download the latest tarball file. You can either use the following command in your terminal or download it from your browser.

wget https://github.com/opensolutions/ViMbAdmin/archive/refs/tags/release-3.1.20.tar.gz

Step 4: Extract the Tarball

After downloading the tarball file, extract it to the /srv/http/ directory using the following command:

sudo tar -xvf release-3.1.20.tar.gz -C /srv/http/

Step 5: Create a MySQL Database

Now, we'll create a new MySQL database for ViMbAdmin. Run the following command to access the MySQL prompt:

sudo mysql -u root -p

Then, create a new database using the following command:

CREATE DATABASE vimbadmin;

Step 6: Create a MySQL User

Next, we need to create a MySQL user with privileges to access the vimbadmin database. Run the following command to create a new user:

CREATE USER 'vimbadmin'@'localhost' IDENTIFIED BY 'password';

Ensure that you replace the password field with your desired password.

Then, grant the new user full privileges to the vimbadmin database:

GRANT ALL PRIVILEGES ON vimbadmin.* TO 'vimbadmin'@'localhost';

When you're done, exit the MySQL prompt by typing:

exit

Step 7: Update ViMbAdmin Configuration

Now, we need to update the configuration file for ViMbAdmin. Navigate to the config directory for ViMbAdmin using the following command:

cd /srv/http/ViMbAdmin-release-3.1.20/config/

Copy the sample configuration file using the following command:

cp config.inc.php.dist config.inc.php

Then, edit the new configuration file using your preferred text editor:

sudo nano config.inc.php

Update the Database section of the file with the following details:

// Database configuration
$config['Database']['host'] = 'localhost';
$config['Database']['port'] = '';    // Leave blank for default
$config['Database']['username'] = 'vimbadmin';
$config['Database']['password'] = 'password';    // Replace with your desired password
$config['Database']['database'] = 'vimbadmin';

Save and exit the file by pressing CTRL + X, then Y, and then ENTER.

Step 8: Enable Apache and MariaDB Services

We need to enable and start the Apache and MariaDB services for ViMbAdmin to function correctly. Run the following commands:

sudo systemctl enable httpd
sudo systemctl start httpd
sudo systemctl enable mariadb
sudo systemctl start mariadb

Step 9: Access ViMbAdmin

Now, you should be able to access ViMbAdmin in your web browser by visiting http://localhost/ViMbAdmin-release-3.1.20/. Log in using the default credentials (username: admin, password: admin), and you should be directed to the ViMbAdmin dashboard.

Congratulations! You have successfully installed ViMbAdmin on Manjaro.