Common errors

I have an error with my filesystem permissions

If you see a message such as the following:

Cannot start service sql: b"error while creating mount source path '/var/local/szurubooru/sql': mkdir /var/local/szurubooru: read-only file system"

then you should ensure that the mountpoint for the data directory ($MOUNT_DATA in .env) is owned by UID/GID 1000:1000, but you need to do this on the host machine, not inside the container (Example: chown -R 1000:1000 /var/local/szurubooru if your mountpoint is /var/local/szurubooru)

Another cause of this problem can be using docker installed from a snap package. If you have the entry docker showing up in snap’s sudo snap list then you should remove docker snap sudo snap remove docker. Once you’ve removed the snap based docker you’ll need to install docker using your distro’s package management system.