Available Flags
| Setting | Flag | Environment Variable | Default |
|---|
| Port | --port | PORT | 9876 |
| Config file | --config | PGCONSOLE_CONFIG | Demo mode |
Examples
npx
npx @pgplex/pgconsole --port 3000 --config /path/to/pgconsole.toml
Docker
# Demo mode (no config needed)
docker run -p 9876:9876 pgplex/pgconsole
# With config file
docker run -p 9876:9876 -v /path/to/pgconsole.toml:/etc/pgconsole.toml pgplex/pgconsole
# Custom port
docker run -p 3000:3000 -e PORT=3000 -v /path/to/pgconsole.toml:/etc/pgconsole.toml pgplex/pgconsole
# Pass config via environment variable (useful for PaaS like Railway where we can't mount file)
docker run -p 9876:9876 -e PGCONSOLE_CONFIG="$(cat /path/to/pgconsole.toml)" pgplex/pgconsole
PGCONSOLE_CONFIG contains the full TOML configuration as a string. When set, pgconsole parses it directly instead of reading from a file. --config takes precedence over PGCONSOLE_CONFIG. This is useful for PaaS platforms (Railway, Cloudflare, etc.) where you cannot mount files.
