Configuration

Pad is designed to work with zero configuration, but offers several ways to customize behavior.

Project File: .pad.toml

Each project has a .pad.toml file in its root directory, created by pad init. This file links the directory to a Pad workspace:

workspace = "my-project"

This is the only setting in .pad.toml — it tells the CLI which workspace this directory belongs to.

Global Config: ~/.pad/config.toml

Server and editor settings are stored in the global config file at ~/.pad/config.toml:

host = "127.0.0.1"
port = 7777
url = ""
editor = ""
log_level = "info"

Settings

Key	Default	Description
`host`	`127.0.0.1`	Server bind address
`port`	`7777`	HTTP server port
`url`	—	Full base URL override (e.g. `https://pad.example.com`). When set, the CLI connects to this URL instead of constructing one from host/port.
`editor`	`$EDITOR`	Editor for `pad item edit` command
`log_level`	`info`	Logging verbosity
`password`	—	Optional password for web UI authentication. See Self-Hosting.

Environment Variables

Variable	Default	Description
`PAD_HOST`	`127.0.0.1`	Server bind address (overrides config)
`PAD_PORT`	`7777`	Server port (overrides config)
`PAD_URL`	—	Full base URL override (overrides config)
`PAD_PASSWORD`	—	Web UI password (overrides config). When set, requires login.
`PAD_DB_PATH`	`~/.pad/pad.db`	Path to SQLite database file
`EDITOR`	—	Editor for `pad item edit` command

CLI Flags

`pad server start`

Start the Pad server manually (usually auto-started):

pad server start --port 8080 --host 0.0.0.0

Flag	Default	Description
`--port`	`7777`	Server port
`--host`	`127.0.0.1`	Bind address

Workspace Detection

Pad finds your workspace by walking up the directory tree looking for .pad.toml. This means you can run pad commands from any subdirectory:

my-project/
├── .pad.toml          ← workspace link (workspace = "my-project")
├── src/
│   └── (your code)    ← `pad` works here too
└── docs/
    └── (your docs)    ← and here

The SQLite database is stored globally at ~/.pad/pad.db (not in the project directory), so multiple workspaces share a single database.

Precedence

Configuration values are resolved in this order (highest priority first):

CLI flags (--port 8080)
Environment variables (PAD_PORT=8080)
~/.pad/config.toml settings
Built-in defaults