From a0cd17a2578876b6d067685c5a342d6befd89dc2 Mon Sep 17 00:00:00 2001 From: Jens Langhammer Date: Sat, 17 Apr 2021 20:09:03 +0200 Subject: [PATCH] docs: add troubleshooting for permission issues Signed-off-by: Jens Langhammer --- .../troubleshooting/image_upload_backup.md | 19 +++++++++++++++++++ website/sidebars.js | 1 + 2 files changed, 20 insertions(+) create mode 100644 website/docs/troubleshooting/image_upload_backup.md 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", ], }, {