Skip to content

S3-compatible

You can use Amazon S3 or any other S3-compatible storage (like MinIO or Ceph Object Gateway) to handle your image uploads in HedgeDoc.

Your S3 bucket must be configured to be writeable.

You just add the following lines to your configuration:
(with the appropriate substitution for <ACCESS_KEY>, <SECRET_KEY>, <BUCKET>, <REGION>, and <ENDPOINT> of course)

HD_MEDIA_BACKEND="s3"
HD_MEDIA_BACKEND_S3_ACCESS_KEY="<ACCESS_KEY>"
HD_MEDIA_BACKEND_S3_SECRET_KEY="<SECRET_KEY>"
HD_MEDIA_BACKEND_S3_BUCKET="<BUCKET>"
HD_MEDIA_BACKEND_S3_ENDPOINT="<ENDPOINT>"
HD_MEDIA_BACKEND_S3_REGION="<REGION>"
HD_MEDIA_BACKEND_S3_PATH_STYLE="<true|false>"

<ENDPOINT> should be an URL and contain the protocol, the domain and if necessary the port. For example: https://s3.example.org or http://s3.example.org:9000

<PATH_STYLE> should be set to true if you are using a S3-compatible storage like MinIO that uses path-style URLs.

If you use Amazon S3, <ENDPOINT> should contain your Amazon Region. For example: If your Amazon Region is us-east-2,your endpoint <ENDPOINT> should be https://s3.us-east-2.amazonaws.com.