How to Install ViMbAdmin on Clear Linux Latest

ViMbAdmin is an open-source web-based application designed to manage virtual mail domains and accounts. It can be used to create and edit email domains, users, aliases, and distribution lists. In this tutorial, we are going to cover the steps required to install ViMbAdmin on the Clear Linux latest version.

Prerequisites

Before we start the installation, make sure that you have fulfilled these requirements:

  • A Clear Linux system installed
  • A sudo user account to perform administrative tasks

Step 1: Update Clear Linux

The first step is to ensure that your Clear Linux system is updated to the latest version.

Run the following commands to update:

sudo swupd update
sudo swupd bundle-add os-core-update

Step 2: Install the Required Packages

To install ViMbAdmin, we need to install several packages. The packages we need are:

  • MariaDB
  • Apache
  • PHP
  • Git

Run the following command to install these packages:

sudo swupd bundle-add mariadb-server apache php-basic git

Step 3: Configure the MariaDB Database

ViMbAdmin requires a database to store configuration and user data. We'll use MariaDB for this purpose. Follow the instructions below to configure the MariaDB database:

Start by enabling the MariaDB service:

sudo systemctl enable mariadb

Then start the MariaDB service:

sudo systemctl start mariadb

Next, secure the MariaDB installation using the command below. Answer the prompts as needed:

sudo mysql_secure_installation

Once the installation is secure, create a new database and user for ViMbAdmin:

sudo mysql -u root -p

MariaDB [(none)]> CREATE DATABASE vimbadmin;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON vimbadmin.* TO 'vimbadmin'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> exit;

Replace the 'password' with a strong password of your choice.

Step 4: Install ViMbAdmin

We can now clone the ViMbAdmin repository from Github:

git clone https://github.com/opensolutions/ViMbAdmin.git

Next, move the ViMbAdmin directory to the Apache document root:

sudo mv ViMbAdmin /var/www/html/

Change permission of ViMbAdmin directory:

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

Copy the configuration file template and edit it to match your environment:

cd /var/www/html/ViMbAdmin/config
sudo cp config.inc.php.dist config.inc.php
sudo nano config.inc.php

Update the following lines:

$config['username']   = 'vimbadmin';
$config['password']   = 'password';
$config['db_name']    = 'vimbadmin';
$config['db_host']    = '127.0.0.1';
$config['db_port']    = '3306';
$config['default_domain'] = 'example.com';

Replace 'vimbadmin' with the username you created earlier, and replace 'password' with the corresponding password you created.

Step 5: Configure Apache

We now need to configure Apache to serve ViMbAdmin. Create a new Virtual Host file:

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

Add the following Virtual Host configuration:

<VirtualHost *:80>
    ServerAdmin [email protected]
    DocumentRoot /var/www/html/ViMbAdmin/public
    ServerName mail.example.com
    <Directory /var/www/html/ViMbAdmin/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Replace '[email protected]' and 'mail.example.com' with your information.

Next, enable and restart Apache:

sudo systemctl enable httpd
sudo systemctl restart httpd

Step 6: Finish ViMbAdmin Installation

Now you can access the ViMbAdmin web interface at http://mail.example.com/vimbadmin/.

When you access it, the installation wizard should start. Here are the steps:

  • Accept the license agreement and click next.
  • Verify that the dependencies are installed, and click next.
  • Configure the database settings, and click test database settings. Once the test is successful, click next.
  • Configure the admin user settings, and click Create admin account.
  • Review the configuration and click install.

After this, the installation wizard will end, and you will be redirected to the login page.

Conclusion

ViMbAdmin is now installed and ready to use. You can log in to the web interface using the admin credentials you set up during the installation process. You can now manage your virtual mail domains and accounts with ease.