From b528d57afdb76b16c4399c950610925f882fd846 Mon Sep 17 00:00:00 2001 From: Emelia Smith Date: Mon, 18 Mar 2024 02:01:20 +0100 Subject: [PATCH] Add troubleshooting instructions for mariadb on debian --- running-pixelfed/troubleshooting.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/running-pixelfed/troubleshooting.md b/running-pixelfed/troubleshooting.md index c0200ef..eb75916 100644 --- a/running-pixelfed/troubleshooting.md +++ b/running-pixelfed/troubleshooting.md @@ -21,3 +21,6 @@ First, check that `OAUTH_ENABLE=1` is set in `.env`. If the problem persists, tr ## 419 Session Expired error Make sure you have `SESSION_DOMAIN`, `APP_URL` and `APP_DOMAIN` set in your `.env`. + +## Database migrations fail on debian / mariadb due to unknown charset +Edit `/etc/mysql/mariadb.conf.d/50-server.cnf` and replace `character-set-collations = utf8mb4=uca1400_ai_ci` with `character-set-collations = utf8mb4=utf8mb4_unicode_ci`, then restart mariadb. Essentially mariadb on debian uses `uca1400_ai_ci` by default, when pixelfed expects `utf8mb4_unicode_ci`. You may need to `ALTER DATABASE CHARACTER SET = 'utf8mb4_unicode_ci';` afterwards.