https://github.com/dedis/d-voting
📧 E-Voting platform based on the Dela blockchain
https://github.com/dedis/d-voting
blockchain e-voting
Last synced: 8 months ago
JSON representation
📧 E-Voting platform based on the Dela blockchain
- Host: GitHub
- URL: https://github.com/dedis/d-voting
- Owner: dedis
- License: bsd-3-clause
- Created: 2021-06-10T11:26:01.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2024-12-10T13:12:33.000Z (over 1 year ago)
- Last Synced: 2024-12-10T14:27:16.390Z (over 1 year ago)
- Topics: blockchain, e-voting
- Language: Go
- Homepage: https://dedis.github.io/d-voting
- Size: 14.1 MB
- Stars: 18
- Watchers: 7
- Forks: 7
- Open Issues: 75
-
Metadata Files:
- Readme: README.docker.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# D-Voting/DELA setup w/ Docker Compose
## Overview
The files related to the Docker environment can be found in
* `docker-compose/` (Docker Compose files)
* `Dockerfiles/` (Dockerfiles)
* `scripts/` (helper scripts)
### Setup
It is recommended to use the `run_docker.sh` helper script for setting up and
tearing down the environment as it handles all the necessary intermediary steps
to have a working D-Voting application.
This script needs to be executed at the project's root.
To set up the environment:
```
./scripts/run_docker.sh
```
This will run the subcommands:
- `setup` which will build the images and start the containers
- `init_dela` which will initialize the DELA network
- `local_admin` which will add local admin accounts for testing and debugging
- `local_login` which will set a local cookie that allows for interacting w/ the API via command-line
- `add_proxies` which will set up the DELA node proxies
Each of these subcommands can also be run by invoking the script w/ the subcommand:
```
./scripts/run_docker.sh
```
/!\ The `init_dela` subcommand must only be run exactly **once**.
To tear down the environment:
```
./scripts/run_docker.sh teardown
```
This will:
- remove the local cookie
- stop and remove the containers and their attached volumes
- remove the images
/!\ This command is meant to reset your environment. If you want to stop one or more
containers, use the appropriate `docker compose` commands (see below for using the correct `docker-compose.yml`).
### Docker environment
There are two Docker Compose file you may use:
* `docker-compose/docker-compose.yml` (recommended, default in `.env.example` and `run_docker.sh`), or
* `docker-compose/docker-compose.debug.yml`, which contains some additional debugging tools
To run `docker compose` commands w/ the right `docker-compose.yml`, you need to either run
```
export COMPOSE_FILE=
```
or
```
source .env
```