HedgeDoc Docker Image¶
The official docker images are available on quay.io.
We currently only support the
The easiest way to get started with HedgeDoc and Docker is to use the following
This is a minimal example to get started quickly and not intended for production use.
version: '3' services: database: image: postgres:13.4-alpine environment: - POSTGRES_USER=hedgedoc - POSTGRES_PASSWORD=password - POSTGRES_DB=hedgedoc volumes: - database:/var/lib/postgresql/data restart: always app: # Make sure to use the latest release from https://hedgedoc.org/latest-release image: quay.io/hedgedoc/hedgedoc:1.9.0 environment: - CMD_DB_URL=postgres://hedgedoc:password@database:5432/hedgedoc - CMD_DOMAIN=localhost - CMD_URL_ADDPORT=true volumes: - uploads:/hedgedoc/public/uploads ports: - "3000:3000" restart: always depends_on: - database volumes: database: uploads:
docker-compose up, HedgeDoc should be available at http://127.0.0.1:3000.
You can now continue to configure your container with environment variables. Check out the configuration docs for more details.
Before you upgrade, always read the release notes.
You can find them on our releases page.
Upgrading to 1.7
Together with changing the name to "HedgeDoc" the default username,
password and database name have been changed in
In order to migrate the existing database to the new default credentials, run
docker-compose exec database createuser --superuser -Uhackmd postgres docker-compose exec database psql -Upostgres -c "alter role hackmd rename to hedgedoc; alter role hedgedoc with password 'password'; alter database hackmd rename to hedgedoc;"
You can upgrade to the latest release by stopping the containers and changing the referenced image version in
docker-compose up to start HedgeDoc again.
Migrating from CodiMD & HackMD¶
If you currently use CodiMD or HackMD, you should be able to swap the docker image for ours. See the general migration hints for compatibility details.
If you use a PostgreSQL database, you can leverage this command to create a backup:
docker-compose exec database pg_dump hedgedoc -U hedgedoc > backup.sql
If you want to restore your PostgreSQL backup, run these commands before starting the application for the first time:
docker-compose up -d database cat backup.sql | docker exec -i $(docker-compose ps -q database) psql -U hedgedoc