1
0
mirror of https://github.com/juanfont/headscale.git synced 2024-12-20 19:09:07 +01:00
juanfont.headscale/docs/ref/configuration.md
Florian Preinstorfer d2a86b1ef2 Fix broken indent
2024-12-04 06:08:44 +01:00

1.7 KiB

Configuration

  • Headscale loads its configuration from a YAML file
  • It searches for config.yaml in the following paths:
    • /etc/headscale
    • $HOME/.headscale
    • the current working directory
  • Use the command line flag -c, --config to load the configuration from a different path
  • Validate the configuration file with: headscale configtest

!!! example "Get the example configuration from the GitHub repository"

Always select the [same GitHub tag](https://github.com/juanfont/headscale/tags) as the released version you use to
ensure you have the correct example configuration. The `main` branch might contain unreleased changes.

=== "View on GitHub"

    * Development version: <https://github.com/juanfont/headscale/blob/main/config-example.yaml>
    * Version {{ headscale.version }}: <https://github.com/juanfont/headscale/blob/v{{ headscale.version }}/config-example.yaml>

=== "Download with `wget`"

    ```shell
    # Development version
    wget -O config.yaml https://raw.githubusercontent.com/juanfont/headscale/main/config-example.yaml

    # Version {{ headscale.version }}
    wget -O config.yaml https://raw.githubusercontent.com/juanfont/headscale/v{{ headscale.version }}/config-example.yaml
    ```

=== "Download with `curl`"

    ```shell
    # Development version
    curl -o config.yaml https://raw.githubusercontent.com/juanfont/headscale/main/config-example.yaml

    # Version {{ headscale.version }}
    curl -o config.yaml https://raw.githubusercontent.com/juanfont/headscale/v{{ headscale.version }}/config-example.yaml
    ```