How to Install HomeBox on Windows 11

HomeBox is a self-hosted email server that enables users to control their emails and personal data. This tutorial will guide you through the steps to install HomeBox on Windows 11.

Prerequisites

Before installing HomeBox, you need to ensure that the following prerequisites are met:

• An active internet connection
• Docker installed on your Windows 11 machine
• Git installed on your Windows 11 machine

Installation Steps

1. Open Command Prompt on your Windows 11 machine.

2. Clone the HomeBox repository by running the following command in Command Prompt:

   git clone https://github.com/progmaticltd/homebox.git
   

3. Change your working directory to the downloaded HomeBox repository by running the following command:

   cd homebox
   

4. Open the .env file in the HomeBox directory using a text editor of your choice.

5. Configure the required settings in the .env file. You can modify the following settings:

   • DOMAIN: The domain name under which your HomeBox server will be accessible.
   • EMAIL: The email address through which system alerts and notifications will be sent.
   • TZ: The timezone for your HomeBox server.

6. Save the .env file after making the necessary modifications.

7. Start the HomeBox server by running the following command:

   docker-compose up -d
   

8. Wait for the server to start up completely. You can check the status of the server by running the command:

   docker-compose ps
   

   If the server is running, you will see output similar to the following:

      Name                     Command               State           Ports
   ----------------------------------------------------------------------------
   homebox_mailsync_1    dockerd-entrypoint.sh        Up
   homebox_postfix_1     postfix -c /etc/postfix ...   Up      587/tcp, 25/tcp
   homebox_redis_1       docker-entrypoint.sh redis    Up      6379/tcp
   homebox_nginx_1       nginx -g daemon off;          Up      80/tcp, 0.0.0.0:443->443/tcp
   homebox_phpfpm_1      docker-php-entrypoint ph ...  Up      9000/tcp
   homebox_dovecot_1     dovecot -F                   Up      0.0.0.0:143->143/tcp, 0.0.0.0:993->993/tcp
   homebox_trainer_1     dockerd-entrypoint.sh        Up
   

9. You can now access your HomeBox server by navigating to https://<domain name> in your web browser. You will need to add a security exception for the SSL certificate before proceeding.

10. Log in to the HomeBox server with the default username admin and password admin.

11. Once you have logged in, you can start configuring your HomeBox server as per your requirements.

Congratulations! You have successfully installed HomeBox on Windows 11.