diff options
author | Toby Jaffey <toby@ringtailsoftware.co.uk> | 2022-12-12 10:26:38 +0000 |
---|---|---|
committer | Toby Jaffey <toby@ringtailsoftware.co.uk> | 2022-12-12 10:26:38 +0000 |
commit | 4afa513dced3b9ef024bc366b4fc884802730d50 (patch) | |
tree | 51098e478054a66439e98dfab89cbbedf5d9f5c0 /README.md | |
parent | aa82e14bc7e7a3770feb23446d1a843d97213ccf (diff) |
Add docker-compose support, so a working development server with HTTPS can be started with:
docker-compose build && docker-compose up
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 13 |
1 files changed, 13 insertions, 0 deletions
@@ -43,6 +43,19 @@ Run `make` and then `make install` as root. See the administrator manual on how to proceed from here. +# Testing via Docker + +A `docker-compose` file is provided for development and testing. To start snac with an nginx HTTPS frontend, run: + + docker-compose build && docker-compose up + +This will: + +- Start snac, storing data in `data/` +- Configure snac to listen on port 8001 with a server name of `localhost` (see `examples/docker-entrypoint.sh`) +- Create a new user `testuser` and print the user's generated password on the console (see `examples/docker-entrypoint.sh`) +- Start nginx to handle HTTPS, using the certificate pair from `nginx-alpine-ssl/nginx-selfsigned.*` (see `examples/nginx-alpine-ssl/entrypoint.sh`) + # License See the LICENSE file for details. |