ARKDEP(8)

NAME
arkdep - Manage arkdep deployments

SYNOPSIS
arkdep {option} <version>...
arkdep {option} [variant] [version]

DESCRIPTION
Arkdep is a utility which downloads, deploys and manages Btrfs subvolume exports. It is able to perform atomic and immutable system updates, migrate local data to new deployments and update the systemd-boot bootloader configuration with entries for said new deployments.

OPTIONS

  deploy
Deploy a new or update an existing deployment.

  init
Initialize arkdep on a new system.

  teardown
Remove all arkdep-deploy related files and folders.

  cleanup
Remove any hanging images, unfinished downloads and untracked deployments.

  healthcheck
Check for and report any config issues or untracked deployments.

  get-available
Get and print available variants in repo.

  reset-config
Reset the Arkdep configuration file (default: /arkdep/config) back to default settings, and create a backup of the current file.

  overlay-restore
Copy the overlay contents to the current root

  overlay-backup-users
Copy the user account files to the overlay.

  diff
Generate and print diff between current deployment and an image from the repos.

  remove
Remove specified deployments.

  layer
Install a package to the current deployment and any future deployments.

  unlayer
Remove a layered package from the current deployment and no longer layer it on future deployments.

  layer-ls
List all packages to be layered.

ENVIRONMENT

  ARKDEP_ROOT
Prepend path to arkdep target directory, implies ARKDEP_CONFIRM.

  ARKDEP_BOOT
Set custom /boot location, overwrites ARKDEP_ROOT on relevant tasks if set. Implies ARKDEP_LEGACY_INITRAMFS.

  ARKDEP_CONFIRM
Skip interactive prompts.

  ARKDEP_CONFIG
Override configuration file location.

  ARKDEP_DATABASE
Override repository database filename.

  ARKDEP_LEGACY_INITRAMFS
Build the initramfs using binaries and files sourced from the current root, kernel modules and dracut configuration are still acquired from the new deployment.

EXAMPLES

  arkdep deploy
Check for updates, if available download and deploy.

  arkdep deploy test-arkanelinux-kde
Download and deploy the latest version of the defined image variant.

  arkdep deploy - stable_v1
Download the specified image version from the default variant.

  arkdep deploy test-arkanelinux-kde stable_v1
Download the defined image version from the specified variant.

  arkdep deploy cache stable_v1
Deploy an image from the local cache skipping database download and checksum check.

  arkdep remove stable_v1
Remove the defined deployment.

  arkdep diff
Generate diff between currently active deployment and latest version of the default variant.

  arkdep diff test-arkanelinux-kde
Generate diff between current deployment and latest version of the specified variant.

  arkdep diff test-arkanelinux-kde aabbcc123
Generate diff between current version and a defined version of a specified variant.