writefreely/docs
2
0
Fork 0
mirror of https://github.com/writefreely/documentation.git synced 2024-11-14 23:11:03 +00:00
Code Issues Releases Wiki Activity

Add troubleshooting section

Browse Source
This commit is contained in:
Herzenschein 2023-10-06 17:56:29 -03:00 committed by GitHub
parent 98efeedcf8
commit ac2124ba78
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 25 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
admin/docker.md
View File

@ -63,3 +63,28 @@ The main differences here are that the use of Docker Networks is not required ex
* You can run `podman run --pod pod_writefreely --network writefreely_writefreely --name writefreely --rm --interactive --tty --mount type=bind,source=./config.ini,destination=/go/config.ini,rw docker.io/writeas/writefreely:latest db init` to initialize the database while in a pod
Once your containers are running, you may then generate systemd service files using [podman-generate-systemd](https://docs.podman.io/en/latest/markdown/podman-generate-systemd.1.html), generate a Kubernetes Deployment using [podman-kube-generate](https://docs.podman.io/en/latest/markdown/podman-kube-generate.1.html), or even better, use [Podman Quadlets](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html) instead of compose files for easy integration with systemd.
## Troubleshooting container issues
WriteFreely will attempt to generate keys if you do not provide your own with
`writefreely generate keys`. If you fail to mount the volume correctly, you will see:
```
ERROR: 2023/07/31 02:52:02 main.go:120: init keys: open keys/email.aes256: no such file or directory
```
If you fail to initialize the database, you will see:
```
Error 1146: Table 'writefreelydb.collections' doesn't exist.
```
You should use 0.0.0.0 as your bind in the configuration file. Otherwise,
you will see:
```
curl http://localhost:8080
curl: (56) Recv failure: Connection reset by peer
```
If your config file contains `open_registration=false` and `single_user=true`, you will see "Page not found".