Overview

Pad is local-first project management for developers and AI coding agents. Single Go binary, SQLite by default, MCP-ready (Claude Code / Cursor / Windsurf). Your data stays on your Unraid box — no telemetry, no account required, no cloud lock-in. After install, click the container's Logs button to grab the first-run bootstrap token, then visit the WebUI to claim the first admin. See the install guide for screenshots: https://getpad.dev/docs/self-hosting/Unraid

Runtime arguments

Web UI
http://[IP]:[PORT:7777]/
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUI PortPorttcp

Pad web UI. Browse to http://[your-tower]:[port]/ after install.

Target
7777
Default
7777
Value
7777
AppdataPathrw

Pad's persistent data: SQLite database, attachments, encryption key, logs, and config. Back this up to keep your workspace safe.

Target
/data
Default
/mnt/user/appdata/pad/
Value
/mnt/user/appdata/pad/
PUIDVariable

User ID the pad process runs as. Default 99 (nobody) matches Unraid's appdata permissions. Change only if you know what you're doing — must be a positive integer.

Default
99
Value
99
PGIDVariable

Group ID the pad process runs as. Default 100 (users) matches Unraid's appdata permissions. Change only if you know what you're doing — must be a positive integer.

Default
100
Value
100
Log LevelVariable

Verbosity for the server log. One of: debug, info, warn, error.

Target
PAD_LOG_LEVEL
Default
info
Value
info
Bypass Setup TokenVariable

If true, the first admin account can be created directly from the web UI (browse to http://[your-tower]:[port]/setup) without copying a bootstrap token from the container logs. Convenient for trusted home networks. Default false (token required from logs). WARNING: while no users exist, anyone who can reach the WebUI port can claim the first admin account — only set true on networks you trust (LAN behind a firewall, Tailscale, etc.). Once an admin exists this setting has no effect.

Target
PAD_BYPASS_SETUP_TOKEN
Default
false
Value
false
Public URLVariable

External URL when pad is behind a reverse proxy (SWAG / NGINX Proxy Manager / etc.). Required for emailed invitation links to point at the right host. Example: https://pad.example.com

Target
PAD_URL
Maileroo API KeyVariable

Optional. Enables transactional email (workspace invitations). Without it, invites use copyable join codes via the CLI. Sign up at maileroo.com.

Target
PAD_MAILEROO_API_KEY
Email FromVariable

Sender address for invitation emails. Required if Maileroo API Key is set. Must be on a domain you control.

Target
PAD_EMAIL_FROM
Email From NameVariable

Display name on outbound emails (the human-friendly part before the address). Defaults to 'Pad'.

Target
PAD_EMAIL_FROM_NAME
Default
Pad
Value
Pad

Categories

Details

Repository
ghcr.io/perpetualsoftware/pad:latest
Last Updated2026-05-31
First Seen2026-05-12

Run Pad on Unraid.

Pad is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.