boltcard/docs/DOCKER_INSTALL.md
2023-02-01 15:48:54 +13:00

1.5 KiB

Bolt card service installation using Docker

install Docker engine and Docker compose

Set up the boltcard server

  • edit .env to set up the database connection
  • edit settings.sql to set up bolt card system settings
    • Put the tls.cert file and admin.macaroon files in the project root directory and in the settings.sql, set the paths to the files to /boltcard/tls.cert and /boltcard/admin.macaroon
  • edit Caddyfile to set the boltcard domain name

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

$ docker volume create caddy_data
// add -d for detached mode
$ docker-compose up -d

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.

running create bolt card command

  • docker exec boltcard_main createboltcard/createboltcard to see options
  • docker exec boltcard_main createboltcard/createboltcard -enable -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