Services Configuration Guide
Overview

Services Configuration Guide

December 17, 2024
2 min read

This section focuses on configuring the Docker services that will run in your homelab: getHomepage for your dashboard, Media Stack for streaming services, and Traefik for reverse proxy and SSL management.

getHomepage Configuration

/docker/homepage/

No edits are needed in the homepage folder. If you’d like to use an existing configuration, you can extract the archive, add your files, and re-archive it. Alternatively, after deployment, configurations will be available in the VM under /home/homepage/.

Media Stack Configuration

/docker/media-stack/

To ensure the Media Stack services are accessible within your network, update the DNS values in the labels section of the media_stack configuration. Focus on the "rule=Host" entries, where you need to replace the example DNS values with your own domain or DNS configuration from your local DNS server (e.g., Pi-hole, Unbound, Technitium).

For example:

- "traefik.http.routers.jellyseer-media.rule=Host(`jellyseer.local`)"

Replace jellyseer.local with your custom domain:

- "traefik.http.routers.jellyseer-media.rule=Host(`jellyseer.merox.cloud`)"

This ensures the services are accessible at jellyseer.merox.cloud or any domain configured in your environment.

Traefik Configuration

V1: Return to this step after deployment is complete (config will be in /home/traefik on the deployed machine).
V2: Extract the archive, edit as shown below, and re-archive.

docker-compose.yaml

Update all instances of yourdomain.com to your actual domain. Ensure this change is made in all four occurrences.
Provider used: Cloudflare.

.env

This hidden file contains credentials for the Traefik dashboard. Default credentials:

  • Username: user
  • Password: password

Edit these if needed.

data/config.yml

Optional file for adding services outside Docker (e.g., your Proxmox IP for SSL access at proxmox.mydomain.com).

data/traefik.yml

Replace [email protected] with your Cloudflare email.

Post-Configuration Step

Danger

After deployment, create a file named cf_api_token.txt in /home/traefik/ with your Cloudflare API token. This step is crucial for starting the Traefik container.

Start the container manually:

Terminal window
/usr/local/bin/docker-compose up &

Additional Resources

For more on Traefik, check out this detailed guide.

Next Steps

Proceed to the Infrastructure Setup guide to configure Packer and Terraform for automated VM deployment.

Share this post

How did you like this post?