caddytail 0.1.0

Caddy web server with Tailscale plugin, packaged for pip installation

caddytail

Caddy web server with the Tailscale plugin, packaged for pip installation.

Installation

pip install caddytail

Usage

Once installed, the caddytail command is available on your PATH:

# Show version
caddytail version

# List modules (should include tailscale)
caddytail list-modules

# Run with a Caddyfile
caddytail run --config /path/to/Caddyfile

# Start in the background
caddytail start

# Stop the background server
caddytail stop

Tailscale Integration

This build of Caddy includes the Tailscale plugin, which allows you to:

• Serve sites directly on your Tailscale network
• Use Tailscale for automatic HTTPS certificates
• Authenticate users via Tailscale identity

Example Caddyfile

{
    # Use Tailscale for serving
    tailscale
}

# Serve on your Tailscale network
my-server.tail-scale.ts.net {
    respond "Hello from Tailscale!"
}

See the caddy-tailscale documentation for more details.

Supported Platforms

Pre-built wheels are available for:

Platform	Architecture
Linux (glibc)	x86_64, aarch64
macOS	x86_64 (Intel), arm64 (Apple Silicon)
Windows	x86_64

Building from Source

If you need to build for a platform not listed above, you can build locally:

# Clone the repository
git clone https://github.com/yourusername/caddytail
cd caddytail

# Install Go and xcaddy
go install github.com/caddyserver/xcaddy/cmd/xcaddy@latest

# Build caddy with the tailscale plugin
xcaddy build --with github.com/tailscale/caddy-tailscale --output src/caddytail/bin/caddy

# Build the wheel
pip install build
python -m build --wheel

License

This project packages Caddy (Apache 2.0 License) with the Tailscale plugin (BSD 3-Clause License).

Links

• Caddy
• Tailscale
• caddy-tailscale plugin
• xcaddy