3.0 KiB
Homelab Setup
- Domain Name
- Port Forwarding and Firewall Rules
- Configuration
- Start Containers
- Administration Setup
- Maintenance
This walks you through setup of this homelab docker-compose template into a working production environment.
Domain Name
In order for this to work, you're going to need a domain name. Do a search for the best domain name registrars and pick one. Then search up domain names you would like until you find something available. Then, as long as you aren't trying to get something fancy like .gg or .ai, the yearly payments shouldn't be too bad.
Once you have purchased it, you'll need to create an A record for that domain pointing to your IP address (i.e. the IP from your VPS, or the public IP of your home). Then, you'll need CNAME records for each subservices to point to the domain name you chose. Here is an example:
Domain: example.com
| Type | Host | Value |
|---|---|---|
| A Record | @ | 142.251.32.46 |
| CNAME Record | nextcloud | example.com |
| CNAME Record | gitea | example.com |
| CNAME Record | freshrss | example.com |
| CNAME Record | homepage | example.com |
The following setup would:
- Redirect example.com to 142.251.32.46
- Redirect nextcloud.example.com (a subdomain of example.com) to whatever example.com is redirected to (142.251.32.46)
- Redirect gitea.example.com (another subdomain of example.com) to whatever example.com is redirected to (142.251.32.46)
- etc…
As you can see, every single subdomain points to the exact same IP address. However, Nginx Proxy will decide what to show you based on what subdomain you're connecting to. In this sense, you can only connect to the services by supplying the correct subdomain (you can't necessarily connect to your Nextcloud instance via a local IP, like 192.168.1.43).
TODO Port Forwarding and Firewall Rules
You only need to care about port forwarding if you are setting this up on your home network.
Configuration
In the docker-compose.yml file, configure the following:
-
MOST IMPORTANT: CHANGE ALL THE PASSWORDS IN ALL THE ENVIRONMENT FILES (found in the env directory)
- THEY ALL SAY CHANGEME SO THERE IS NO EXCUSE FOR MISSING THIS
- Set the
VIRTUAL_HOST,LETSENCRYPT_HOSTandLETSENCRYPT_EMAILfor each service accordingly - Set the time zone (
TZ) for the containers that request it
Start Containers
Once everything is properly configured and you've double-checked it, you can start all the necessary containers by running:
# inside of homelab directory
sudo docker-compose up -dAdministration Setup
Now, immediately navigate to each public-facing service (Nextcloud, Gitea, FreshRSS, Heimdall). If everything went correctly, you should be greeted with an installation page to complete. This is where you will configure an admin account for the website, so make sure to do it fast before some script kiddy compromises your server!
Maintenance
For more details on maintaining this environment, see maintenance.org.