Synopsis
fishnet restore FILE [--yes]
Arguments
Path to the backup file to restore.
Skip the confirmation prompt and restore immediately.
Examples
Restore with confirmation
fishnet restore ~/.local/share/fishnet/backups/vault-20260303-143015.db.bak
Restore vault from '~/.local/share/fishnet/backups/vault-20260303-143015.db.bak' and overwrite current vault? [y/N]: y
Vault restored from ~/.local/share/fishnet/backups/vault-20260303-143015.db.bak
Restore without confirmation
fishnet restore ~/backups/vault.db.bak --yes
Vault restored from ~/backups/vault.db.bak
Restore and verify
fishnet restore vault-backup.db.bak --yes
fishnet list-keys
Behavior
- Checks if Fishnet is running and refuses to restore if it is
- Verifies the backup file exists
- Prompts for confirmation unless
--yes is used
- Removes the current vault database
- Copies the backup file to the vault location
- Sets file permissions to owner-only (mode 0600)
Error messages
Server is running:
fishnet appears to be running; stop it before restore
fishnet stop first.
Backup file not found:
backup file does not exist: ~/backups/vault.db.bak
failed to create vault dir: <error>
failed to remove existing vault db: <error>
failed to restore vault backup: <error>
Exit codes
- 0 - Vault restored successfully or user cancelled
- 1 - Error occurred (server running, file not found, etc.)
Safety precautions
- Always stop Fishnet before restoring (
fishnet stop)
- Verify the backup file before restoring (
ls -lh <file>)
- Consider creating a backup of the current vault before restoring
- Test the restored vault with
fishnet list-keys after restoration
Recovery workflow
If you accidentally overwrite credentials:
# Stop the server
fishnet stop
# Restore from backup
fishnet restore ~/.local/share/fishnet/backups/vault-20260303-143015.db.bak --yes
# Verify credentials
fishnet list-keys
# Restart the server
fishnet start