Commit 273f7179 authored by Nick Busey's avatar Nick Busey

Fixes and docs

parent 8ffdb4f0
Pipeline #39071110 canceled with stage
......@@ -14,6 +14,16 @@ To change any setting, edit your `config.yml` file, then run `make config` again
To reset your settings, run `make config_reset`, then run `make config` again.
## Debugging
### 404
If you're up and running, but getting a 404, load [http://YOURSERVERIP:8181/]. This is the Traefik dashboard.
Each service under the `Frontends` column has a section `Route Rule - Host:`. The hostname after `Host:` is the
hostname that Traefik is listening to for that particular service. You need to be able to `ping` that hostname
from your computer, and you should get back the IP address of your server. Once that is the case, accessing the
hostname in a browser will load the respective service.
## Network Configuration
It is recommended to register an actual domain to point at your Homelab, but if you can't or would prefer not to, you can use HomelabOS fully inside your network. Simply make up a domain that ends in `.local` and enter that as your domain in `host_vars/myserver`.
......
......@@ -84,7 +84,11 @@
ignore_errors: "yes"
- debug:
msg: "HomelabOS Installed successfully! Go to https://{{ domain }}/ to get started. You can also access your services via Tor at http://{{ tor_http_domain_file.stdout }}/ Finally you can SSH to {{ tor_ssh_domain_file.stdout }}"
msg: "HomelabOS Installed successfully! Go to https://{{ domain }}/ to get started."
- debug:
msg: "You can also access your services via Tor at http://{{ tor_http_domain_file.stdout }}/ Finally you can SSH to {{ tor_ssh_domain_file.stdout }}"
when: enable_tor
- debug:
msg: "Problems? File an issue at https://gitlab.com/NickBusey/HomelabOS/issues"
......
......@@ -35,6 +35,7 @@
- unattended-upgrades
- vim
- zsh
- docker.io
- docker-compose
tags:
- dependencies
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment