Upgrading

Keeping your Suricatavel installation up to date ensures you receive the latest detection capabilities, security updates, and performance optimizations.

Upgrade methods

Suricatavel supports two upgrade methods:

Unified CLI update (recommended)
System package manager

Upgrading via CLI

The recommended upgrade method is using the unified suricatavel update command:

Run the update command:
Terminal window
```
suricatavel update
```
The command performs the following sequence:
- Checks the upstream repository for new releases.
- Displays a version comparison summary.
- Enables application maintenance mode.
- Upgrades application packages via apt or dnf.
- Runs database migrations (migrate --force).
- Rebuilds application, route, and config caches.
- Reloads Supervisor workers.
- Disables maintenance mode.
Verify system health:
Terminal window
```
suricatavel status
suricatavel version
```

Update options

Option	Description
`--backup`	Create a full database backup before running migrations (backups are skipped by default).
`--skip-cleanup`	Prevent automated pruning of older database backup files.
`--no-rollback`	Disable automated rollback in the event of migration failure.
`--no-tui`	Disable interactive terminal formatting (plain-text output).
`--force`	Execute without interactive confirmation prompts.

Examples:

# Standard interactive update
suricatavel update

# Update with an explicit database backup
suricatavel update --backup

# Automated unattended update for scripts
suricatavel update --force --no-tui

Upgrading via package manager

Alternatively, you can upgrade packages directly using the operating system package manager, followed by running suricatavel deploy:

Debian / Ubuntu
RHEL / Rocky Linux

sudo apt update
sudo apt upgrade suricatavel
suricatavel deploy --migrate

sudo dnf upgrade suricatavel
suricatavel deploy --migrate