How to Install Homer on macOS

Homer is a self-hosted dashboard and time-tracker that allows you to keep track of your projects, tasks, time spent, and more. Here's a step-by-step tutorial on how to install Homer on macOS:

Prerequisites

Before you begin, make sure you have the following installed on your system:

• Docker: Homer is built using Docker, so you need to install Docker Desktop for macOS. You can download it from the Docker website.

Installation

1. Clone the Homer repository from GitHub by running the following command in your terminal:

   git clone https://github.com/bastienwirtz/homer.git
   

2. Change to the homer directory:

   cd homer
   

3. Create a new file called .env:

   cp sample.env .env
   

4. Open the .env file in your favorite text editor and set your environment variables:

   HOMER_DOMAIN=localhost
   HOMER_PORT=8181
   HOMER_POSTGRES_PASSWORD=<your-secret-password>
   HOMER_ADMIN_PASSWORD=<your-secret-password>
   

   Note: Replace <your-secret-password> with your own secure password.

5. Start Docker:

   docker-compose up -d
   

6. Wait for Docker to finish building the containers. This may take a few minutes.

7. Visit http://localhost:8181 in your web browser.

8. Log in to Homer using the default email address [email protected] and the password you set in the .env file.

   Congrats! You've successfully installed Homer on your macOS system. Now you can start tracking your time and managing your projects.