diff --git a/website/docs/troubleshooting/image_upload_backup.md b/website/docs/troubleshooting/image_upload_backup.md new file mode 100644 index 000000000..55cf74337 --- /dev/null +++ b/website/docs/troubleshooting/image_upload_backup.md @@ -0,0 +1,19 @@ +--- +title: Errors when uploading icons / during backups +--- + +:::info +This is specific to the docker-compose installation, if you're running into issues on Kubernetes please open a GitHub issue. +::: + +This issue is most likely caused by permissions. Docker creates bound volumes as root, but the authentik processes don't run as root. + +This will cause issues with icon uploads (for Applications), background uploads (for Flows) and local backups. + +To fix these issues, run these commands in the folder of your docker-compose file: + +```shell +sudo chown 1000:1000 backups/ +sudo chown 1000:1000 media/ +sudo chown 1000:1000 custom-templates/ +``` diff --git a/website/sidebars.js b/website/sidebars.js index 3add7fc2e..d96459aa9 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -160,6 +160,7 @@ module.exports = { "troubleshooting/access", "troubleshooting/emails", "troubleshooting/login", + "troubleshooting/image_upload_backup", ], }, {