How to Install Homebox on Manjaro

Homebox is an open-source email gateway that provides a user-friendly web interface to manage email accounts and domains. In this tutorial, we will guide you on how to install Homebox on Manjaro in a few simple steps.

Prerequisites

Before installing Homebox, you need to ensure that you have the following requirements installed on your Manjaro system:

Git
Docker
Docker Compose
Nginx

To install these prerequisites, you can use the following command:

sudo pacman -S git docker docker-compose nginx

Installing Homebox

Once you have installed the required dependencies, you can now proceed to install Homebox on your Manjaro system. Follow the below steps to install Homebox:

Clone the Homebox repository from Github using the following command:
```
git clone https://github.com/progmaticltd/homebox.git
```
Change the directory to the cloned repository using the following command:
```
cd homebox
```
Copy the example environment file to a new file named .env using the following command:
```
cp .env.example .env
```
Update the .env file with your desired values. You need to provide the following information:
- MAIL_DOMAINS: the list of domains that you want to use for email services.
- POSTGRES_PASSWORD: the password for the PostgreSQL database.
- SYPHT_API_KEY: the API key for Sypht, if you want to use document classification.
- ADMIN_EMAIL: the email address for the Homebox admin user.
- ADMIN_PASSWORD: the password for the Homebox admin user.
Start the Homebox services using the following command:
```
docker-compose up -d
```
This command will build the Homebox containers and start the services in the background. You should see the services running by running the following command:
```
docker ps
```

Configure Nginx to proxy requests to the Homebox container. You can do this by creating a new Nginx configuration file using the following command:

sudo nano /etc/nginx/conf.d/homebox.conf

Then, paste the following configuration into the file:

server {
    listen 80;
    listen [::]:80;

    server_name mail.example.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host $host;
    }
}

Replace mail.example.com with your domain name. Save and exit the file.

Restart Nginx for the changes to take effect:
```
sudo systemctl restart nginx
```

You have now successfully installed Homebox on Manjaro. You can access the Homebox web interface by visiting http://mail.example.com in your web browser. Log in using the admin email and password that you provided in the .env file. From here, you can manage your email domains, accounts, and settings.