Skip to content

Tailscale

Description / nameInput element
Container Registry
Container Configuration Root Path
Tailscale /config Path

Build Status Last Commit

Tailscale mesh VPN on FreeBSD.

Version Tags

Tag Description Best For
latest FreeBSD Port. Installs from latest packages. Most users. Matches Linux Docker behavior.
pkg FreeBSD Port. Installs from Quarterly ports. Stability. Uses system libraries.
pkg-latest FreeBSD Port. Installs from Latest ports. Bleeding edge system packages.

Prerequisites

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.

Deployment

services:
  tailscale:
    image: ghcr.io/daemonless/tailscale:latest
    container_name: tailscale
    environment:
      - TS_AUTHKEY=tskey-auth-xxxx
      - TS_EXTRA_ARGS=--advertise-exit-node
    volumes:
      - /path/to/containers/tailscale:/config
    restart: unless-stopped
podman run -d --name tailscale \
  -e TS_AUTHKEY=tskey-auth-xxxx \
  -e TS_EXTRA_ARGS=--advertise-exit-node \
  -v /path/to/containers/tailscale:/config \ 
  ghcr.io/daemonless/tailscale:latest
- name: Deploy tailscale
  containers.podman.podman_container:
    name: tailscale
    image: ghcr.io/daemonless/tailscale:latest
    state: started
    restart_policy: always
    env:
      TS_AUTHKEY: "tskey-auth-xxxx"
      TS_EXTRA_ARGS: "--advertise-exit-node"
    volumes:
      - "/path/to/containers/tailscale:/config"

Interactive Configuration

Parameters

Environment Variables

Variable Default Description
TS_AUTHKEY tskey-auth-xxxx Optional: Tailscale Auth Key for automatic login
TS_EXTRA_ARGS --advertise-exit-node Optional: Additional arguments for tailscale up

Volumes

Path Description
/config State directory (tailscaled.state)

Implementation Details

  • Architectures: amd64
  • User: root (UID/GID set via PUID/PGID). Defaults to 1000:1000.
  • Base: Built on ghcr.io/daemonless/base (FreeBSD 15.0).

Website Source Code FreshPorts


Need help? Join our Discord community.