Merge pull request #122 from ThisIsMissEm/patch-1

Add troubleshooting instructions for mariadb on debian
pixelfed · Aug 18, 2024 · 4f55ec8 · 4f55ec8
2 parents 41be4d3 + b528d57
commit 4f55ec8
Showing 1 changed file with 3 additions and 0 deletions.
diff --git 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 <name> CHARACTER SET = 'utf8mb4_unicode_ci';` afterwards.