lxmin

README

lxmin

Backup and restore LXC instances from MinIO

Install

Binary Releases

OS	ARCH	Binary
Linux	amd64	linux-amd64
Linux	arm64	linux-arm64
Linux	ppc64le	linux-ppc64le
Linux	s390x	linux-s390x
Apple M1	arm64	darwin-arm64
Apple	amd64	darwin-amd64
Windows	amd64	windows-amd64

Setup

Enable MinIO endpoint, bucket and access credentials.

export LXMIN_ENDPOINT=http://localhost:9000
export LXMIN_BUCKET="backups"
export LXMIN_ACCESS_KEY="minioadmin"
export LXMIN_SECRET_KEY="minioadmin"

Usage

lxmin --help

NAME:
  lxmin - backup and restore LXC instances from MinIO

USAGE:
  lxmin [FLAGS] COMMAND [COMMAND FLAGS | -h] [ARGUMENTS...]

COMMANDS:
  backup      backup an instance image to MinIO
  restore     restore an instance image from MinIO
  info        pretty print tags on an instance image on MinIO
  list, ls    list all backups from MinIO
  delete, rm  deletes a specific backup by 'name' for an instance from MinIO

GLOBAL FLAGS:
  --endpoint value    endpoint for S3 API call(s) [$LXMIN_ENDPOINT]
  --bucket value      bucket on MinIO to save/restore backup(s) [$LXMIN_BUCKET]
  --access-key value  access key credential for S3 API [$LXMIN_ACCESS_KEY]
  --secret-key value  secret key credential for S3 API [$LXMIN_SECRET_KEY]
  --help, -h          show help

Create a backup

lxmin backup u2
Exporting backup from lxc backup_2022-02-16-04-1040.tar.gz... Done
Uploading backup_2022-02-16-04-1040.tar.gz [==========================================================================================================================] 101.25 MiB/s

Create a backup (optimized supported for ZFS and BTRFS storage pools)

Creating optimized backups when possible is a good practice, allows for faster restore times for your backups during disaster recovery.

lxmin backup u2 --optimized
Exporting backup from lxc backup_2022-02-16-04-1040.tar.gz... Done
Uploading backup_2022-02-16-04-1040.tar.gz [==========================================================================================================================] 101.25 MiB/s

List all backups

lxmin list
┌──────────┐┌──────────────────────────────────┐┌───────────────────────────────┐┌─────────┐┌───────────┐
│ Instance ││ Name                             ││ Created                       ││ Size    ││ Optimized │
│          ││                                  ││                               ││         ││           │
│ u2       ││ backup_2022-02-16-05-0102.tar.gz ││ Wed, 16 Feb 2022 05:01:56 GMT ││ 666 MiB ││ ✗         │
│ u2       ││ backup_2022-02-16-22-4725.tar.gz ││ Wed, 16 Feb 2022 22:49:07 GMT ││ 871 MiB ││ ✗         │
│ u2       ││ backup_2022-02-16-23-4340.tar.gz ││ Wed, 16 Feb 2022 23:44:55 GMT ││ 890 MiB ││ ✔         │
└──────────┘└──────────────────────────────────┘└───────────────────────────────┘└─────────┘└───────────┘

Restore a backup

lxmin restore u2 backup_2022-02-16-04-1040.tar.gz
Downloading backup_2022-02-16-04-1040.tar.gz [========================================================================================================================] 212.41 MiB/s
Importing instance 'u2', from 'backup_2022-02-16-04-1040.tar.gz'... Done
Starting instance 'u2'... Done

Pretty print any tags on a backup

lxmin info u2 backup_2022-02-16-22-4725.tar.gz
┌──────┐┌────────┐
│ Key  ││ Value  │
│      ││        │
│ key1 ││ value1 │
│ key2 ││ value2 │
│ key3 ││ value3 │
└──────┘└────────┘

Delete a backup

Delete a specific backup by name backup_2022-02-16-04-1040.tar.gz

lxmin delete u2 backup_2022-02-16-04-1040.tar.gz
Backup backup_2022-02-16-04-1040.tar.gz deleted successfully

Delete all backups

lxmin delete u2 --all --force
All backups for u2 deleted successfully