- Replace all AdventureLog references with Voyage across ~102 files (7 case variants: AdventureLog, adventurelog, Adventurelog, ADVENTURELOG, AdventUrelog, AdventureLOG, adventure-log, adventure_log) - Rename brand, static, and documentation assets to use voyage naming - Rename install_adventurelog.sh → install_voyage.sh - Update README.md and voyage_overview.md to credit AdventureLog as the upstream project and Sean Morley as its original creator
1.7 KiB
Kubernetes and Kustomize (k8s)
Voyage can be run inside a kubernetes cluster using kustomize.
Prerequisites
A working kubernetes cluster. Voyage has been tested on k8s, but any Kustomize-capable flavor should be easy to use.
Cluster Routing
Because the Voyage backend must be reachable by both the web browser and the Voyage frontend, k8s-internal routing mechanisms traditional for standing up other similar applications cannot be used.
In order to host Voyage in your cluster, you must therefor configure an internally and externally resolvable ingress that routes to your Voyage backend container.
Once you have made said ingress, set PUBLIC_SERVER_URL and PUBLIC_URL env variables below to the url of that ingress.
Tailscale and Headscale
Many k8s homelabs choose to use Tailscale or similar projects to remove the need for open ports in your home firewall.
The Tailscale k8s Operator will set up an externally resolvable service/ingress for your Voyage instance, but it will fail to resolve internally.
You must expose tailnet IPs to your cluster so the Voyage pods can resolve them.
Getting Started
Take a look at the example config and modify it for your use case.
Environment Variables
Look at the environment variable summary in the docker install section to see available and required configuration options.
Enjoy Voyage! 🎉