Backup Sets
Create, configure, and manage backup sets to control exactly what gets backed up and when.
What Is a Backup Set?
A backup set is a named configuration that groups together the folders you want to protect, the file patterns you want to exclude, and the schedule on which backups run. You can create multiple backup sets to organize different types of data — for example, one set for documents, another for project files, and a third for media.
Each backup set tracks its own version history independently, so you can restore any set to any previous point in time without affecting others.
Creating a Backup Set
As of v1.12.2, file-type backup sets can be created from the GUI wizard or the command line. Server-class types (Hyper-V, SQL, sysstate, BMR) still require the GUI wizard because they capture too many type-specific options to fit cleanly on a flag-driven CLI.
- •Open the BackupEngine desktop agent and go to the Backup tab.
- •Click New Backup Set in the top-right corner, or Create First Backup Set in the middle of the tab when the computer has no sets yet.
- •Backup Set Name is filled in as the computer's name followed by "- Files", for example OFFICE-PC - Files. Keep it or type your own (e.g., 'Work Documents', 'Photos').
- •Under Folders to Back Up, click Choose Folders, tick every folder you want and confirm. Ticking a folder includes everything inside it. See Choosing Folders below.
- •Optionally, edit the exclude patterns to skip files you do not need (see below).
- •Under Destinations, pick one or more: BackupEngine Cloud, Local PC, Network PC, Google Drive or OneDrive.
- •Under Backup Schedule, choose One Time, Hourly, Daily, Weekly, Bi-Weekly or Monthly and the time (see Scheduling). To run the set on more schedules, for example every 2 hours during the day plus daily at 02:00, click Add another time.
- •Turn on Continuous Data Protection (CDP) or Open File Backup (VSS) if you need them.
- •Click Create Backup Set.
# v1.12.2+ — create a file backup set, single source, local destination.
backupengine sets create file "Work Documents" \
--source "C:\Users\you\Documents" \
--dest local --local-path "D:\backups"
# Multiple sources can be passed comma-separated.
backupengine sets create file "Source Code" \
--source "C:\src,C:\Users\you\Projects" \
--dest local --local-path "D:\backups"
# Cloud destination — no --local-path needed.
backupengine sets create file "Photos" \
--source "E:\Photos" \
--dest cloud
# CLI-created sets default to schedule=manual + email off. Flip email policy
# with sets email; switch the schedule with the GUI (rich UI for cadence).
backupengine sets email "Work Documents" only-on-failure
# Remove a set you no longer need.
backupengine sets delete "Work Documents"ℹ Note
⚠ Warning
sets delete removes the local set definition. It does NOT wipe data already uploaded to the destination — that is the GUI-only Cleanup-on-Delete dialog (multi-step confirmation by design).Choosing Folders
From v1.37.0 you can choose many folders at once. Choose Folders opens a folder tree with Quick access (your own folders, such as Desktop, Documents and OneDrive) and This PC (your drives and their free space; as in File Explorer, empty CD drives and card readers without a card are left out). Nothing changes until you confirm, and Cancel leaves the set as it was.
- •In the backup set form, under Folders to Back Up, click Choose Folders.
- •Tick each folder to back up. Ticking a folder includes everything inside it. Click the same tick-box again to undo it; any folders you had ticked inside it come back. Click a folder's name to open or close it.
- •To add a path the tree does not show, type or paste it in Add path…, one per line: a network share such as \\server\share, or several folders copied with File Explorer's Copy as path. If a path is still in the box when you confirm, it is added first; if it cannot be added, the dialog stays open and says why.
- •Or click Browse with Windows… and Ctrl- or Shift-click several folders in the familiar Windows dialog.
- •Confirm. The chosen folders appear under Folders to Back Up with their sizes once measured. If a folder you added as you confirmed gets a warning, the dialog stays open so you can see it; confirm again to close it.
- •Keyboard: the arrow keys move through the tree, Space ticks, Enter confirms and Esc cancels. Tab moves between the tree, the chosen folders, the path box and the buttons; Tab to a folder's chip to read its warning.
# Pass several folders to --source, separated by commas.
backupengine sets create file "Office files" \
--source "C:\Users\you\Documents,C:\Users\you\Desktop,\\server\share\Projects" \
--dest cloud
# The CLI adds the folders exactly as given; to change them later, edit the set in the app.
backupengine sets list⚠ Warning
ℹ Note
💡 Tip
Backup Destinations
BackupEngine supports multiple backup destination types. You can back up to a single destination or simultaneously to multiple destinations for redundancy. See Multi-Destination Backup to learn how to implement a 3-2-1 backup strategy in one backup set.
- •BackupEngine Cloud — encrypted storage on iDrive e2 with zero egress fees. Default, recommended for off-site protection.
- •Local PC — back up to a local folder or external drive on the same machine. Fast, no internet required.
- •Network PC — back up to a shared network folder (SMB/CIFS). Good for on-premises NAS or file server.
- •Google Drive — back up to your Google Drive account via OAuth. Uses your existing Google storage.
- •OneDrive — back up to your Microsoft OneDrive account via OAuth. Uses your existing Microsoft storage.
💡 Tip
Exclude Patterns
Exclude patterns let you skip files and directories that do not need to be backed up. This reduces backup size, speeds up scans, and avoids wasting storage on temporary or generated files.
- •Wildcard patterns: *.tmp, *.log, *.cache — skip files by extension.
- •Directory names: node_modules, .git, __pycache__, build, dist — skip entire folders.
- •Path patterns: /Users/me/Downloads/** — skip a specific directory tree.
- •Size filters: files larger than a configured threshold can be excluded automatically.
- •Hidden files: optionally exclude dot-files and dot-directories.
💡 Tip
Inspecting and Running Backup Sets
Once the set exists, both the GUI and the CLI can list the configuration, kick off a manual run, and tail recent jobs.
- •Open the Backup tab. Each set shows its name, schedule, destinations, last-run status, and total size.
- •Click a set to expand its destination list and see per-destination success/fail counts.
- •Use Run Now to trigger an immediate backup outside the regular schedule.
- •Click the kebab menu to Pause, Duplicate, or Delete a set.
backupengine sets list # All sets, multi-destination fan-out included backupengine sets list --json # Same data, machine-readable backupengine backup start "Documents" # Run one set by name backupengine backup start # Run every enabled set backupengine backup list 50 # 50 most recent jobs backupengine sets email "Documents" only-on-failure # Flip per-set email policy
ℹ Note
backup start <name> drives the real runner end-to-end (it was a print-only stub through v1.11.x). After a successful run the CLI also runs retention prune + chunk-GC sweep inline (v1.12.4+), matching GUI behaviour exactly.⚠ Warning
sets delete only removes the local set definition; uploaded data on the destination stays put. See Cleanup on Delete for the wipe flow.Cancelling a Running Backup
Both the Files tab and the Server Backup tab cards expose a Cancel button while a backup is in flight. The runner stops at the next file or chunk boundary (typically <1 second). Per-type cleanup runs automatically — Hyper-V drops the in-progress reference checkpoint, BMR / System State delete their staging directories, SQL drops the temp .bak. Chunks already uploaded remain on the destination and dedup automatically on the next run; no manifest is written for a cancelled run, so it will not appear in the Restore picker.
- •Find the running set on either the Files tab or the Server Backup tab.
- •Click Cancel on the card.
- •Confirm in the "Cancel running backup?" dialog.
- •Within ~1 second the run stops and the card returns to its idle state.
backupengine backup stop # Stop every active backup backupengine backup stop "Documents" # Stop a specific set by name
ℹ Note
Cleanup on Delete (v1.11.8)
When you delete a backup set the GUI shows a three-checkbox dialog so you can decide what other artefacts to clean up alongside the set record. Defaults are deliberately conservative — only the local diagnostic logs are pre-checked.
- •Delete uploaded backup data — wipes every chunk + manifest at every destination configured for the set. CANNOT BE UNDONE — restores from this set become impossible. Default OFF.
- •Delete diagnostic logs on this machine — per-run text files saved locally for troubleshooting. Default ON (cosmetic).
- •Delete report history (server-side) — every entry in the Reports tab for this set. Default OFF (preserves audit history).
ℹ Note