Self-hosting · Draft

Troubleshooting

Draft. This page is written from the product plan and has not been checked against a release.

Start with three checks. They answer most questions.

Status #

eddy status

It shows whether the containers are running, and the version, plan and team members in use. See the command list.

Logs #

eddy logs
eddy logs app

The first follows everything. The second follows one service: app, caddy, or db for the bundled database. Certificate problems show up in the caddy logs.

Health #

curl -s https://<your domain>/api/health

A healthy install returns { "ok": true, "db": true }. If db is false, the app is running but cannot reach the database.

Common causes #

No certificate. The domain does not point at this server, or ports 80 and 443 are blocked. Fix DNS or the firewall. Use --no-tls only for tests.
Mail is not arriving. Check the Email section of /admin/settings and send a test email. See email.
The sign-in button is missing. The Sign-in section of /admin/settings shows any configuration problem. See sign-in.
A new person cannot be added. You are at your team member limit. See licence.

Asking for help #

Public issues are at https://github.com/sectorflow/eddy-releases/issues. Paste the output of eddy status. Never paste your .env, because it holds your secrets.

Edit this page