Skip to content

deucalion gui

Opens the app. Typing just deucalion does the same when you are on a desktop.

$ deucalion gui --help
usage: deucalion gui [-h]

open the app (also what plain 'deucalion' does)

options:
  -h, --help  show this help message and exit

Without a desktop (for example over SSH), plain deucalion prints the list of commands instead:

$ bin/deucalion
usage: deucalion [-h] [--version] COMMAND ...

Back up your Ubuntu machine to an external drive, and restore or rebuild from it.

positional arguments:
  COMMAND
    gui          open the app (also what plain 'deucalion' does)
    deps         check (and install) what Deucalion needs, including VeraCrypt
    drives       list connected drives
    register     use a drive (or a folder on it) for backups
    targets      list registered backup drives
    setup-drive  prepare a drive for backups (format, encrypt)
    open         unlock an encrypted backup drive
    close        lock/unmount the backup drive so it can be unplugged
    backup       back up everything, or only some folders
    status       show the state of the backup
    ls           list what is in the backup (with original names)
    restore      restore files or folders from the backup
    rebuild      rebuild this machine from a backup (new machine or new Ubuntu)
    verify       check the backup on the drive is complete and undamaged
    removed      list or empty _removed/ (old versions and deleted files)
    exclude      manage what is left out of your home backup
    folder       manage extra folders outside your home (e.g. /srv)
    profile      manage saved selections for partial backups
    config       show or edit the configuration

options:
  -h, --help     show this help message and exit
  --version      show program's version number and exit

If the app's libraries are missing: "The app can't start (…). The python3-gi, gir1.2-gtk-4.0 and gir1.2-adw-1 packages are needed." Install them with deucalion deps --install.

The app needs Ubuntu 24.04 or newer. On older versions it says "The app needs Ubuntu 24.04 or newer (libadwaita 1.5; this computer has 1.1). Everything also works from the terminal: run 'deucalion --help' to see the commands."

Exit codes

0 when the app is closed; 1 if it can't start.