cacert-devsetup/README.md

41 lines
1.1 KiB
Markdown
Raw Normal View History

# CAcert local development setup
This repository contains a local development environment setup for the CAcert software.
## Prerequisites
* Linux system (tested on Debian Bullseye)
* [Docker](https://tracker.debian.org/pkg/docker.io)
* [docker-compose](https://pypi.org/project/docker-compose/)
* [openssl](https://tracker.debian.org/pkg/openssl)
* [myrepos](https://tracker.debian.org/pkg/myrepos)
```shell
sudo apt-get update
sudo apt-get install docker.io openssl myrepos
sudo adduser $USER docker
newgrp docker
python3 -m pip install --user -U docker-compose
# make sure that ~/.local/bin is in $PATH
```
## Usage
Create a .env file that defines the following variables
Variable | Usage
--- | ---
`MYSQL_ROOT_PASSWORD` | Database root password
`MYSQL_APP_USER` | Database application user
`MYSQL_APP_PASSWORD` | Database application password
```shell
git clone https://git.dittberner.info/jan/cacert-devsetup.git
cd cacert-devsetup
mr checkout
./setup_test_ca.sh
docker-compose up
```
After these steps you should be able to reach the CAcert application at https://test.cacert.localhost:8443/.