Favicon of Headscale

Headscale

Create and manage your own private network with this open-source Tailscale control server. Ideal for self-hosters, hobbyists, and small organizations.

Take full control of your private network with this open-source, self-hosted implementation of the Tailscale control server. It allows you to run your own coordination server, removing the dependency on the official SaaS offering and giving you complete ownership of your network infrastructure.

The primary design goal is to provide a focused and efficient server for a single Tailscale network (tailnet). This makes it an excellent choice for specific use cases where a large, multi-user enterprise setup is not required.

This tool is particularly well-suited for:

  • Hobbyists building personal labs and projects.
  • Self-hosters looking for a private and secure networking solution.
  • Small open-source organizations needing a simple way to connect their resources.

By implementing a narrow scope, it offers a stable and manageable alternative for creating your own secure, point-to-point mesh network.

Directory Structure

headscale
config
config.yaml
data
.env
docker-compose.yml

docker-compose.yml

services:
  headscale:
    image: headscale/headscale:latest
    container_name: headscale
    restart: unless-stopped
    command: headscale serve
    ports:
      - 8080:8080
      - 9090:9090
    volumes:
      - ./config:/etc/headscale
      - ./data:/var/lib/headscale
    environment:
      - HEADSCALE_OIDC_CLIENT_SECRET=${HEADSCALE_OIDC_CLIENT_SECRET}

.env

HEADSCALE_OIDC_CLIENT_SECRET=your_super_secret_oidc_client_secret
Categories:

Share:

Ad
Favicon

 

  
 

Similar to Headscale

Favicon

 

  
  
Favicon

 

  
  
Favicon