auberge

CLI for self-hosted infrastructure management.

auberge [GLOBAL OPTIONS] <COMMAND>

Global options

Option	Description
-v, --verbose	Stream subprocess output (kept on failure, dimmed on success)
-q, --quiet	Suppress chrome on stderr (errors and stdout data unchanged); mutually exclusive with --verbose
--no-color	Disable colored output (or set NO_COLOR env var)
--via <public|tailnet>	Reach hosts over their public or tailnet address for this run, overriding each host’s prefer_tailnet; see Tailnet Transport
-h, --help	Print help
-V, --version	Print version

Commands

Command	Alias	Purpose
deploy	dp	Deploy apps with auto-hardening
versions	v	Report declared App and Tool Versions and upstream drift
ansible	a	Run Ansible playbooks
backup	b	Backup / restore / push / prune / verify
dns	d	Cloudflare DNS management
host	h	Manage hosts.toml
ssh	ss	SSH key generation and deployment
sync	sy	rsync media to the VPS
headscale	hs	Headscale users and nodes
syncthing	st	Pair this machine’s Syncthing with an agent Host
bichon	—	Bichon folder reconciliation
config	c	Manage config.toml
select	se	Interactive host / playbook pickers
completions	—	Generate shell completion script

Files

Purpose	Path
Hosts	~/.config/auberge/hosts.toml
Config	~/.config/auberge/config.toml
Backups	~/.local/share/auberge/backups/
SSH keys	~/.ssh/identities/

See Configuration for details on the config files.

Examples

auberge host add my-vps 203.0.113.10
auberge deploy --all --host my-vps
auberge backup create --host my-vps
auberge dns list