CLICommands
config & update
Global CLI configuration and self-update.
CLI configuration (config)
The global configuration is stored in ~/.portabase/config.json.
| Command | Description |
|---|---|
portabase config show | Show the file path and every known key (unset when not set). Unknown keys are flagged. |
portabase config get <KEY> | Print one value. Fails (exit 2) if the key is not set. |
portabase config set <KEY> <VALUE> | Set a value. |
portabase config channel <stable|beta> | Shortcut for config set update_channel <stable|beta>. |
| Key | Values | Description |
|---|---|---|
update_channel | stable, beta | Which releases update and the update notification follow. When unset, a beta CLI follows beta, a stable CLI follows stable. |
portabase config channel beta
portabase config get update_channelupdate
Updates the CLI binary to the latest release of the active channel.
portabase update- Downloads the binary for your platform and verifies its SHA-256 against the release's
checksums.txt. The update is refused if the checksum file is missing or does not match. - Replaces the running binary and keeps the previous one next to it as
portabase.old. Usessudoif the install directory is not writable. - Asks for confirmation before a downgrade (e.g. switching from
betaback tostable). - Only works with the released binary, not from source.
After a successful command, the CLI may display "A new version of Portabase CLI is available". The check is cached for 24 hours (~/.portabase/cache/release.json) and never runs in non-interactive mode.
Last updated on