FAQ

We cover both frequently asked questions and special cases that would polute the documentation here.

Installation

Environments with SELinux

To make An Otter Wiki run in an environment with SELINUX=enforcing with the methods propose in the Installation document the bind mounts have to be adjusted.

When podman gives you the error message

mkdir: cannot create directory '/app-data': Permission denied

please update your compose.yaml to

services:
  otterwiki:
    image: redimp/otterwiki:2
    restart: unless-stopped
    ports:
      - 8080:80
    volumes:
      - ./app-data:/app-data:Z

For podman please see the podman troubleshooting guide for more details and instructions.

In our tests in rocky:9 docker configured the permissions even with setting the :z flag, please see the docker documentation about bind mounts for more details.

Caddy as reverse proxy provisioning TLS certificates

In an environment with SELINUX=enforcing where Caddy is used as reverse proxy, it was observed that it is necessary to run

setsebool -P httpd_can_network_connect on

to enable Caddy to connect to the internet in order to provision proper TLS certificates.

Errors

413 RequestEntityTooLarge

When An Otter Wiki raises the error 413 RequestEntityTooLarge please configure the variable MAX_FORM_MEMORY_SIZE which is in bytes and by default 500000, see Configuration.