Bolt card service installation using Docker

install Docker engine and Docker compose

Docker engine download & install

Set up the boltcard server

Run ./docker_init.sh to set up the initial data
Put the tls.cert file and admin.macaroon files in the project root directory

https setup

set up the domain A record to point to the server

set up the server hosting firewall to allow open access to https (port 443) only

service bring-up and running

$ sudo groupadd docker
$ sudo usermod -aG docker ${USER}
(log out & in again)
$ docker volume create caddy_data
// add -d option for detached mode
$ docker compose up

stop docker

$ docker compose down

To delete the database and reset the docker volume, run docker compose down --volumes NOTE: caddy_data volume won't be removed even if you run docker compose down --volumes because it's an external volume. Make sure to wipe your programmed cards before wiping the database

check container logs

Docker Logs

$ docker logs [OPTIONS] CONTAINER

Run $ docker ps to list containers and get container names/ids

running create bolt card command

docker exec boltcard_main createboltcard/createboltcard to see options
docker exec boltcard_main createboltcard/createboltcard -enable -allow_neg_bal -tx_max=1000 -day_max=10000 -name=card_1 for example
this will give you a one-time link in text and QR code form

1.5 KiB Raw Blame History