Skip to main content
Database backup and reset operations.

​
Commands

​
ctpf db backup

Create a backup of the database. 
ctpf db backup [PATH]
Arguments:
ArgumentDescription
PATHOptional. Custom path for the backup file.
Default location: ~/.qai/backups/qai-{YYYY-MM-DD-HHMMSS}.db Examples: 
# Backup to default location
ctpf db backup
# Output: Backup created: /home/user/.qai/backups/qai-2025-04-10-143052.db

# Backup to custom path
ctpf db backup /tmp/my-backup.db
# Output: Backup created: /tmp/my-backup.db
Run backups before destructive operations like reset, or before upgrading q-ai versions.

​
ctpf db reset

Reset the database to a clean state. Creates an automatic backup before deletion. 
ctpf db reset [--yes]
Options:
OptionDescription
--yesSkip confirmation prompt.
What gets deleted:
  • All scan targets
  • All runs, findings, and evidence
  • All IPI campaigns and callback hits
What’s preserved:
  • Provider credentials (stored in OS keyring)
  • Provider configurations
  • Default settings
Examples: 
# Interactive reset with confirmation
ctpf db reset
# Output:
# ⚠️  This will delete all targets, runs, findings, and evidence.
# Settings and credentials will be preserved.
# Type RESET to confirm: RESET
# Backup created: /home/user/.qai/backups/qai-2025-04-10-143052.db
# Database reset complete.

# Non-interactive reset
ctpf db reset --yes
Reset is irreversible. The automatic backup is your only recovery option.