Bolt Store

How to backup and recover BindPlane OP when using Bolt Store

When BindPlane OP is configured to use Bolt Store as the storage backend, a bbolt database on the filesystem is created. Bbolt is a high performance database suitable for operating BindPlane OP in a single node configuration.


The Bolt Store database file is constantly written to. In order to guarantee consistency and avoid corruption of the backup file, BindPlane OP must be stopped before the database file can be copied.

sudo systemctl stop bindplane

sudo cp \
    /var/lib/bindplane/storage/bindplane.db \
    /var/lib/bindplane/storage/bindplane-$(date '+%Y-%m-%d_%H:%M:%S').db

sudo systemctl start bindplane

After copying the database file, the storage directory will look something like this:

├── bindplane-2023-08-03_15:04:31.db
└── bindplane.db

It is recommended that the copied database files be moved to a remote system, such as a backup server or a secure object storage service like Google Cloud Storage or Amazon S3.


To restore a backup of Bolt Store, use the following process:

  1. Stop the server: sudo systemctl stop bindplane
  2. Backup the current database file
  3. Copy a previous database backup file to /var/lib/bindplane/storage/bindplane.db
  4. Start BindPlane: sudo systemctl start bindplane