Safety and upkeep

Backups, changes Hoista didn’t hear back about, webhooks, settings and your profile.

`hoist backups`

Backups of Hoista’s state, and moving it to another computer.

hoist backups

`hoist backups now`

Save a backup now.

hoist backups now

`hoist backups restore <NAME>`

Restore a backup into a fresh Hoista.

hoist backups restore backup-2026-11-08T0200

Argument or flag	What it does
`<NAME>`	The backup’s name from hoist backups.

`hoist backups export <FILE>`

Save everything, sign-ins included, in one encrypted file to move to another computer.

hoist backups export ~/hoista.hoista

Argument or flag	What it does
`<FILE>`	The file to write. It is never overwritten.
`--passphrase-stdin`	Read the passphrase from stdin.

`hoist backups import <FILE>`

Bring in a file from hoist backups export.

hoist backups import ~/hoista.hoista --check
hoist backups import ~/hoista.hoista

Argument or flag	What it does
`<FILE>`	The file.
`--check`	Only check it opens and show what’s in it.
`--passphrase-stdin`	Read the passphrase from stdin.

`hoist backups recovery`

Imports that stopped partway, after a crash.

hoist backups recovery

`hoist backups abandon <ID>`

Give up an import that stopped partway.

hoist backups abandon 7d2f...

Argument or flag	What it does
`<ID>`	Its id from hoist backups recovery.

`hoist operations`

Provider operations Hoista started, and checking unclear ones.

hoist operations

`hoist operations check <ID>`

Say whether an operation whose result was lost happened at the provider.

hoist operations check 7d2f... --happened

Argument or flag	What it does
`<ID>`	Operation id from hoist operations.
`--happened`	It happened.
`--did-not-happen`	It didn’t happen.

`hoist webhooks`

Webhooks Hoista calls when things happen.

hoist webhooks

`hoist webhooks add <URL>`

Add a webhook. Its signing secret is shown once.

hoist webhooks add https://example.com/hoista --events deploy.failed,deploy.live -p my-app

Argument or flag	What it does
`<URL>`	The HTTPS address to call.
`--events <EVENTS>`	Only these events, comma-separated, such as deploy.failed. Default: every event.
`-p, --project <PROJECT>`	Only events about this project.

`hoist webhooks remove <ID>`

Remove a webhook.

hoist webhooks remove 5a1e...

Argument or flag	What it does
`<ID>`	Webhook id.

`hoist webhooks rotate <ID>`

Give a webhook a new signing secret; the old one stops working now.

hoist webhooks rotate 5a1e...

Argument or flag	What it does
`<ID>`	Webhook id.

`hoist webhooks deliveries <ID>`

Recent calls to a webhook and how they went.

hoist webhooks deliveries 5a1e...

Argument or flag	What it does
`<ID>`	Webhook id.

`hoist settings`

Hoista’s settings.

hoist settings

`hoist settings get <KEY>`

Print one setting.

hoist settings get backup_keep

Argument or flag	What it does
`<KEY>`	The setting, such as backup_keep.

`hoist settings set <KEY> <VALUE>`

Change one setting.

hoist settings set backup_keep 30
hoist settings set agents_enabled false

Argument or flag	What it does
`<KEY>`	The setting, such as backup_keep.
`<VALUE>`	Its new value.

`hoist profile`

Your name and initials, shown on what you do.

hoist profile

`hoist profile set --name <NAME> --initials <INITIALS>`

Set your name and initials.

hoist profile set --name "Sam Rivera" --initials SR

Argument or flag	What it does
`--name <NAME>`	Your name.
`--initials <INITIALS>`	Up to three initials.

Get started

Commands

Safety and upkeep

`hoist backups`

`hoist backups now`

`hoist backups restore <NAME>`

`hoist backups export <FILE>`

`hoist backups import <FILE>`

`hoist backups recovery`

`hoist backups abandon <ID>`

`hoist operations`

`hoist operations check <ID>`

`hoist webhooks`

`hoist webhooks add <URL>`

`hoist webhooks remove <ID>`

`hoist webhooks rotate <ID>`

`hoist webhooks deliveries <ID>`

`hoist settings`

`hoist settings get <KEY>`

`hoist settings set <KEY> <VALUE>`

`hoist profile`

`hoist profile set --name <NAME> --initials <INITIALS>`

​hoist backups

​hoist backups now

​hoist backups restore <NAME>

​hoist backups export <FILE>

​hoist backups import <FILE>

​hoist backups recovery

​hoist backups abandon <ID>

​hoist operations

​hoist operations check <ID>

​hoist webhooks

​hoist webhooks add <URL>

​hoist webhooks remove <ID>

​hoist webhooks rotate <ID>

​hoist webhooks deliveries <ID>

​hoist settings

​hoist settings get <KEY>

​hoist settings set <KEY> <VALUE>

​hoist profile

​hoist profile set --name <NAME> --initials <INITIALS>

`hoist backups`

`hoist backups now`

`hoist backups restore <NAME>`

`hoist backups export <FILE>`

`hoist backups import <FILE>`

`hoist backups recovery`

`hoist backups abandon <ID>`

`hoist operations`

`hoist operations check <ID>`

`hoist webhooks`

`hoist webhooks add <URL>`

`hoist webhooks remove <ID>`

`hoist webhooks rotate <ID>`

`hoist webhooks deliveries <ID>`

`hoist settings`

`hoist settings get <KEY>`

`hoist settings set <KEY> <VALUE>`

`hoist profile`

`hoist profile set --name <NAME> --initials <INITIALS>`