Install GeoPulse
GeoPulse can run on a single Docker host, a NAS or homelab platform, Kubernetes, or a manually managed Linux server. Start with the path that matches your environment, then use the upgrade and configuration references when you are ready to maintain the deployment.
Choose an Installation Method
| Method | Best For | Start Here |
|---|---|---|
| Docker Compose | Fastest setup for most single-server installs | Docker Compose |
| Unraid | NAS and homelab deployments managed through Unraid | Unraid |
| Proxmox VE LXC | Proxmox hosts using the community helper script | Proxmox VE LXC |
| Kubernetes Quick Install | Scripted Kubernetes installation with Helm | Kubernetes Quick Install |
| Helm Values Reference | Advanced Kubernetes configuration and chart values | Helm Values Reference |
| Manual Installation | Advanced bare-metal or VM installs without containers | Manual Installation |
After Installation
- Complete the Quick Start to reach first login and connect your first location source.
- Review Environment Variables when customizing runtime behavior.
- Follow Upgrading GeoPulse when moving between versions.
Recommended Path
For most users, start with Docker Compose. It is the simplest supported deployment path and maps directly to the default GeoPulse configuration.