From 9e155d93a1ce105ced02dfaff8edfc585e81a6ea Mon Sep 17 00:00:00 2001 From: ICScaryThings Date: Sun, 22 May 2022 01:01:13 -0400 Subject: [PATCH] misc info to readme --- README.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/README.md b/README.md index da2f1e4..fc9f6a5 100644 --- a/README.md +++ b/README.md @@ -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.