53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
# Bolt card service installation using Docker
|
|
|
|
### install Docker engine and Docker compose
|
|
|
|
- [Docker engine download &
|
|
install](https://docs.docker.com/engine/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](https://docs.docker.com/engine/reference/commandline/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
|