Home A - Z
Menu

An Otter Wiki

Blame

29c2be Ralph Thesen 2024-10-19 11:28:18
Added FAQ entry about running An Otter Wiki in a SELinux environment.
1 
# FAQ
2
3
We cover both frequently asked questions and special cases that would polute the documentation here.
4
5
## Installation
6
7
### Environments with SELinux
8
9
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.
10
11
When podman gives you the error message
12
```
13
mkdir: cannot create directory '/app-data': Permission denied
14
```
15
please update your `compose.yaml` to
16
```yaml
17
services:
18
otterwiki:
19
image: redimp/otterwiki:2
20
restart: unless-stopped
21
ports:
22
- 8080:80
23
volumes:
24
- ./app-data:/app-data:Z
25
```
26
27
For podman please see the [podman troubleshooting guide](https://github.com/containers/podman/blob/main/troubleshooting.md#2-cant-use-volume-mount-get-permission-denied) for more details and instructions.
28
7d6142 Ralph Thesen 2025-07-13 20:01:28
Added SELinux hint for Caddy
29
In our tests in `rocky:9 docker` configured the permissions even with setting the `:z` flag, please see the [docker documentation about bind mounts](https://docs.docker.com/engine/storage/bind-mounts/#configure-the-selinux-label) for more details.
30
31
#### Caddy as reverse proxy provisioning TLS certificates
32
33
In an environment with `SELINUX=enforcing` where Caddy is used as reverse proxy, it was observed that it is necessary to run
34
```bash
35
setsebool -P httpd_can_network_connect on
36
```
37
to enable Caddy to connect to the internet in order to provision proper TLS certificates.
00f9ff Ralph Thesen 2025-03-07 22:38:39
added entry about the 413 error
38
39
## Errors
40
41
### 413 RequestEntityTooLarge
42
43
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](/Configuration#content-and-editing-preferences).
e5497a Ralph Thesen 2026-01-12 22:39:13
Added FAQ item on net.core.somaxconn
44
45
### Listen queue size is greater than the system max net.core.somaxconn
46
47
This was reported to happen when using the `-slim` image on a Synology NAS, see [#342](https://github.com/redimp/otterwiki/issues/342). This can be fixed with increasing the value via sysctl or when using a `docker-compose.yaml` with
48
49
```yaml
50
services:
51
otterwiki:
52
image: redimp/otterwiki:2-slim
53
restart: unless-stopped
54
ports:
55
- 8080:80
56
volumes:
57
- ./app-data:/app-data
58
sysctls:
59
- net.core.somaxconn=1024
60
```