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

database setup

copy the .env.example file to .env and change the database password

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.6 KiB Raw Blame History