Installation
Headplane is designed to be deployed within several different environments to ensure that it can seamlessly integrate into your existing infrastructure. First set up your configuration file and then pick the installation method that best suits your needs.
Configuration
Headplane requires a configuration file to operate. A sample file is available to use as a starting point. Some of the important fields include:
| Field | Description |
|---|---|
headscale.url | Point to your Headscale server (e.g., http://headscale.example.com or http://headscale:8080 in Docker). |
server.cookie_secret | Used to encrypt cookies. You can generate a random string using a command like openssl rand -base64 32. |
server.data_path | Just a path to keep in mind, especially if you're using Docker. |
The configuration file is rather complicated and has many more options. Refer to the Configuration guide for a detailed explanation of all the available options, as well as guidance on securely setting up your values through secret path options and environment variables.
Deployment Methods
Headplane can be deployed in several different ways, each with its own set of advantages and trade-offs. Choose the method that best fits your needs:
Docker: Fast and easy deployment using Docker
- Recommended for most users due to its simplicity and ease of use.
- Allows for advanced features like network management and remote web SSH.
- Requires Docker and Docker Compose to be installed.
Native Mode: Direct installation on a server
- Suitable for users who prefer not to use Docker.
- Allows for advanced features like network management and remote web SSH.
- Requires manual setup of dependencies and environment.
Limited Mode: Quick and easy deployment with minimal features
- Ideal for testing or simple environments and not intended for production use.
- Lacks any advanced functionality or integrations such as network management or remote web SSH.