Go to file

peskyadmin 1c7da2bef5 docs: rewrite README with clear Tailscale vs Headscale paths

- Tailscale as default (Quick Start at top)
- Headscale section at bottom with explicit steps
- Clear .env changes for each environment
- Updated serve config switching table

2026-08-02 16:26:58 -04:00

tailscale/config

fix: update serve.headscale.json to use yourdomain.com for consistency

2026-08-02 15:56:00 -04:00

.env.example

docs: improve .env.example with better placeholders and comments

2026-08-02 15:52:35 -04:00

.gitignore

fix: correct serve config assignment and clean up README

2026-08-02 15:54:26 -04:00

docker-compose.yml

refactor: make database volume name service-specific (vikunja-db-data)

2026-08-02 16:22:42 -04:00

README.md

docs: rewrite README with clear Tailscale vs Headscale paths

2026-08-02 16:26:58 -04:00

SECURITY.md

feat: add dual Tailscale/Headscale serve support + template improvements

2026-08-02 15:42:10 -04:00

README.md

Vikunja with Tailscale Integration

This project sets up a Vikunja instance with Tailscale VPN integration using Docker Compose.

Quick Start (Tailscale)

Copy the example environment file and fill in your values:
```
cp .env.example .env
```
Edit .env and set:
- TS_AUTHKEY — your Tailscale auth key
- TS_LOGIN_SERVER — leave as https://controlplane.tailscale.com (default)
Start the stack:
```
docker compose up -d
```
Access Vikunja at http://vikunja.<your-tailnet>.ts.net

Headscale

If you're using Headscale instead of Tailscale:

Copy the example environment file:
```
cp .env.example .env
```
Edit .env and set:
- TS_AUTHKEY — your Headscale auth key
- TS_LOGIN_SERVER — your Headscale server URL

Switch to the Headscale serve config:

cp tailscale/config/serve.headscale.json tailscale/config/serve.json

Edit serve.json and replace vikunja.example.com with your actual domain
Start the stack:
```
docker compose up -d
```
Access Vikunja at http://vikunja.yourdomain.com

Configuration

See .env.example for all available options.

Switching Serve Configs

Environment	File to use	Notes
Tailscale (default)	`tailscale/config/serve.json`	Supports HTTP + HTTPS with certs
Headscale	`tailscale/config/serve.headscale.json`	HTTP only

After changing the serve config, restart the sidecar:

docker compose restart vikunja-ts

Optional: Direct Host Access

Uncomment the ports section in docker-compose.yml if you need direct access without Tailscale:

ports:
  - 3456:3456