Note: Custom jwks key can be passed by adding a jwks.json file in keys folder in each deployment folder such as
/deploy/docker/keys
You’ll need to have Docker and docker-compose installed and running on your host system. Also, the version of docker-compose should be 1.27.0
or above. Check your docker-compose version using:
docker-compose version
You can use prebuilt images generated by our CI workflow.
To use the latest stable version.
curl -o docker-compose.yml https://raw.githubusercontent.com/OWASP/crAPI/main/deploy/docker/docker-compose.yml
docker-compose pull
docker-compose -f docker-compose.yml --compatibility up -d
curl.exe -o docker-compose.yml https://raw.githubusercontent.com/OWASP/crAPI/main/deploy/docker/docker-compose.yml
docker-compose pull
docker-compose -f docker-compose.yml --compatibility up -d
To use the latest development version
curl -o docker-compose.yml https://raw.githubusercontent.com/OWASP/crAPI/develop/deploy/docker/docker-compose.yml
VERSION=develop docker-compose pull
VERSION=develop docker-compose -f docker-compose.yml --compatibility up -d
curl.exe -o docker-compose.yml https://raw.githubusercontent.com/OWASP/crAPI/develop/deploy/docker/docker-compose.yml
set "VERSION=develop"
docker-compose pull
docker-compose -f docker-compose.yml --compatibility up -d
Note: All emails are sent to mailhog service by default and can be checked on http://localhost:8025 You can change the smtp configuration if required however all emails with domain example.com will still go to mailhog.
Clone crAPI repository
$ git clone [REPOSITORY-URL]
$ git clone [REPOSITORY-URL] --config core.autocrlf=input
Build all docker images
$ deploy/docker/build-all.sh
$ call "%cd%\deploy\docker\build-all.bat"
$ docker-compose -f deploy/docker/docker-compose.yml --compatibility up -d
http://localhost:8888
Note: All emails are sent to mailhog service by default and can be checked on
http://localhost:8025
You can change the smtp configuration if required however all emails with domain example.com will still go to mailhog.
git clone [REPOSITORY-URL]
cd deploy/helm
helm install --namespace crapi crapi . --values values.yaml
minikube tunnel --alsologtostderr
Access crAPI
crAPI should be available on the <LOADBALANCER_IP>:8888
Mailhog on <LOADBALANCER_IP>:8025
Or for minikube run the following command to get the URL
crAPI URL:
$ echo "http://$(minikube ip):30080"
Mailhog URL:
echo "http://$(minikube ip):30025"
This option allows you to run crAPI within a virtual machine, thus isolated from your system. You’ll need to have Vagrant and, for example VirtualBox installed.
$ git clone [REPOSITORY-URL]
$ cd deploy/vagrant && vagrant up
http://192.168.33.20
Note: All emails are sent to mailhog service by default and can be checked on
http://192.168.33.20:8025
You can change the smtp configuration if required however all emails with domain example.com will still go to mailhog.
Once you’re done playing with crAPI, you can remove it completely from your system running the following command from the repository root directory
$ cd deploy/vagrant && vagrant destroy
If you need any help with installing and running crAPI you can check out this guide: Troubleshooting guide crAPI. If this doesn’t solve your problem, please create an issue in Github Issues.