How to Install ViMbAdmin on Fedora CoreOS Latest

ViMbAdmin is a web-based interface for administrating virtual mailboxes. It simplifies the task of administrators by enabling them to manage email domains, mailboxes, and aliases through one convenient application. In this tutorial, you will learn how to install ViMbAdmin on Fedora CoreOS Latest.

Step 1: Verify System Requirements

Before installing ViMbAdmin, you need to have the following dependencies installed on your system. You can check the availability of each dependency using the command below:

$ sudo dnf install git php php-imap php-mbstring php-intl php-pdo php-mysqlnd php-xml php-json php-opcache php-gd

Step 2: Clone ViMbAdmin from GitHub

Next, you need to clone the ViMbAdmin repository from GitHub. This will let you obtain the latest codebase of the software.

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

Step 3: Configure the Database

ViMbAdmin requires a MySQL or MariaDB database. You need to configure the database and create a user with permissions to the database.

Install the MariaDB Server package:
```
$ sudo dnf install mariadb-server
```
Enable and start the MariaDB service:
```
$ sudo systemctl enable --now mariadb
```
Create a new user account in MariaDB:
```
$ sudo mysql -u root -p
```

Run the following SQL queries to create a database and a user account:

> CREATE DATABASE vimbadmin_db;
> GRANT ALL PRIVILEGES ON vimbadmin_db.* TO 'vimbadmin'@'localhost' IDENTIFIED BY 'YourPasswordHere';
> FLUSH PRIVILEGES;
> EXIT

Step 4: Configure ViMbAdmin

Now that you have cloned the ViMbAdmin repository and configured the database, you need to configure ViMbAdmin. It’s important to secure your configuration files and directories.

Copy the config file:

$ cp /opt/ViMbAdmin/application/configs/application.ini.dist /opt/ViMbAdmin/application/configs/application.ini

Edit the ViMbAdmin configuration file to match your system. You can find the configuration file at: /opt/ViMbAdmin/application/configs/application.ini.
```
$ cd /opt/ViMbAdmin/
$ sudo nano application/configs/application.ini
```

Add the following lines of code at the end of the file:

[resource.multidb.db2]
host      = localhost
username  = vimbadmin
password  = YourPasswordHere
dbname    = vimbadmin_db
adapter   = pdo_mysql

Step 5: Create the Database Tables

After editing the ViMbAdmin configuration file copy the ViMbAdmin database schema.

$ cd /opt/ViMbAdmin/
$ mysql -u vimbadmin -p vimbadmin_db < ./library/ViMbAdmin/vendor/zendframework/zend-db/bin/mysql-schema.sh

Step 6: Set File Permissions

To ensure ViMbAdmin files and directories are readable and writable by the web server, you need to change their ownership.

$ sudo chown -R apache:apache /opt/ViMbAdmin/data/

Step 7: Create an Apache Virtual Host

To make ViMbAdmin available from a web browser, you need to create a virtual host in Apache.

Create a virtual host configuration file:

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

Add the below lines after editing the ServerName, DocumentRoot, Directory and Alias.

<VirtualHost *:80>
     ServerName example.com
     DocumentRoot /opt/ViMbAdmin/public
         
     DirectoryIndex index.php
         
     Alias /VMA /opt/ViMbAdmin/public/
     <Directory /opt/ViMbAdmin/public>
         AllowOverride All
         Require all granted
     </Directory>
         
     <Directory /opt/ViMbAdmin/public/static>
         ExpiresActive On
         ExpiresDefault "access plus 2 days"
     </Directory>
         
     ErrorLog  /var/log/httpd/vimbadmin-errors.log
     CustomLog /var/log/httpd/vimbadmin-access.log combined
</VirtualHost>

Restart the Apache service.
```
$ sudo systemctl restart httpd
```

Step 8: Access ViMbAdmin in Browser

You can now access the ViMbAdmin web interface by navigating to your Server's IP Address or hostname in the browser followed by VMA or an alias specified in VirtualHost. For example, http://Server-IP/VMA or http://example.com/VMA.

Congratulations! You have successfully installed ViMbAdmin on Fedora CoreOS Latest. You should now be able to configure domains, mailboxes and aliases within the ViMbAdmin web interface.