1.6 KiB
Using HedgeDoc with Docker
Important: This README does not refer to HedgeDoc 1. For setting up HedgeDoc 1 with Docker, see https://docs.hedgedoc.org/setup/docker/.
The Dockerfile in this repo uses multiple stages and can be used to create both images for development
and images with only production dependencies.
It uses features which are only available in BuildKit - see https://docs.docker.com/go/buildkit/ for more information.
Build a production image
Note: This does not include any frontend!
To build a production image, run the following command from the root of the repository:
docker buildx build -t hedgedoc-prod -f backend/docker/Dockerfile .
When you run the image, you need to provide environment variables to configure HedgeDoc.
See the config docs for more information.
This example starts HedgeDoc on localhost, with non-persistent storage:
docker run -e HD_BASE_URL=http://localhost -e HD_MEDIA_BACKEND=filesystem -e HD_MEDIA_BACKEND_FILESYSTEM_UPLOAD_PATH=uploads -e HD_DATABASE_TYPE=sqlite -e HD_DATABASE_NAME=hedgedoc.sqlite -e HD_SESSION_SECRET=foobar -e HD_LOGLEVEL=debug -p 3000:3000 hedgedoc-prod
Build a development image
You can build a development image using the development target:
docker buildx build -t hedgedoc-dev -f backend/docker/Dockerfile --target development .
You can then, e.g. run tests inside the image:
docker run hedgedoc-dev yarn run test:e2e