misc info to readme

This commit is contained in:
ICScaryThings 2022-05-22 01:01:13 -04:00
parent eaa2c093f6
commit 9e155d93a1

View file

@ -24,3 +24,31 @@ NOTE: Unless your user is a member of the `docker` group, you will need root for
The build _should_ complete without errors and if you run `docker image ls` you should
see `treebird:latest` (or whatever alt image tag you set in the previous command).
## Troubleshooting
Various issues I have seen and solutions
### Random Issue I Saw - I
On older versions of debian you need to install `docker.io` to get docker
(the container software) rather than docker (some utility for docking widgets in GUIs I think).
### Random Issue I Saw - II
If the container build fails and you get the following message:
The key(s) in the keyring /etc/apt/trusted.gpg.d/debian-archive-bullseye-automatic.gpg are ignored as the file is not readable by user '_apt' executing
Try building the container locally or on another system. I saw this when running
from debian stable VPS. I think it is some kind of permission issue due to kernel
or docker version differences because the exact same image runs fine on other host distros.
After building elsewhere you can do the following:
docker save treebird:latest -o treebird.dsave
rsync -avP treebird.dsave name@myserver:~/
ssh name@myserver
docker load -i treebird.dsave
### Random Issue I Saw - III
In the nginx config it handles more than one set of a `fastcgi_param` very poorly
so if you `include fastcgi.conf` and try to set SCRIPTNAME after, it will fail to
update it and you will get the usual fastcgi cryptic error.