Homepage Setup Guide

Introduction

Homepage is a modern, fully static, fast, secure, fully proxied, highly customizable application dashboard with integrations for over 100 services and translations into multiple languages.

Prerequisites

• Docker installed
• Homepage container running in your Docker stack

Configuration Steps

Step 1: Accessing the Homepage UI

1. Open your browser and navigate to http://<your-ip-address>:3000.

Step 2: Adding Applications

1. Locate and open the config.yml file within the /app/config directory.

2. Edit the config.yml file to include your applications. Example:

   apps:
     - name: "Google"
       url: "https://www.google.com"
       icon: "https://www.google.com/favicon.ico"
       description: "Search the web with Google"
     - name: "GitHub"
       url: "https://github.com"
       icon: "https://github.githubassets.com/favicons/favicon.png"
       description: "Host and review code, manage projects"
   

3. Save the config.yml file.

4. Restart the Homepage container to apply changes:

   docker-compose -f docker-compose-server1.yaml restart homepage
   

   

Notes

• Ensure all paths and environment variables are updated in the homepage.yaml file.
• Regularly backup your config directory to save your settings.

Troubleshooting

• Common Issues: List common issues and solutions.
• Logs: Check Homepage logs for error messages.
• Support: Link to the Homepage community and support resources.