Guides
Troubleshooting
Find the message that you see. Each page gives its cause and the repair.
Start ferryd. ferryd stops with an Error: line and its cause.
1 / 6
Each page shows a message as Ferry prints it. A … replaces the parts that change with your setup.
For a failed deploy, the full story is in its log. The page of the deploy in the dashboard shows the same log.
ferry logs --deploy DEPLOY_IDFind your problem
When ferryd starts. ferryd tests its data directory, its addresses and Docker before it starts.
| What you see | Page |
|---|---|
cannot connect to Docker | ferryd cannot connect to Docker |
Address already in use | A port is in use |
Permission denied (os error 13) | Permission denied on port 80 or 443 |
another ferryd is already running | Another ferryd uses the data directory |
belong to another Ferry server | The Docker prefix belongs to another server |
When you sign in to the dashboard.
| What you see | Page |
|---|---|
This is not the setup code of this server. | The dashboard asks for a setup code |
| You do not know the password | I forgot the password |
too many failed attempts | Too many failed attempts |
When you use the CLI.
| What you see | Page |
|---|---|
cannot reach Ferry server | The CLI cannot reach the server |
not logged in, invalid API token | Not logged in, or the token is wrong |
the login request expired | ferry login does not finish |
During a build. The live deploy continues to answer.
| What you see | Page |
|---|---|
could not detect the runtime | Ferry cannot detect the runtime |
secret env mounts need Docker Engine 27.3 | Builds fail on an old Docker Engine |
the docker CLI ('docker') was not found | ferryd cannot find the docker CLI |
not enough free disk space | The disk is almost full |
During a deploy. The previous deploy continues to answer. See Health checks.
| What you see | Page |
|---|---|
nothing accepts connections on container port | The health check times out |
GET /healthz returned HTTP 404 | The health check path answers with an error |
crashed (exit code 1) | The app crashes |
exited with code 0 | The app exits immediately |
ran out of memory | The app runs out of memory |
When you open your app.
| What you see | Page |
|---|---|
404, 502 or 503 with an x-ferry-error header | The proxy answers with an error |
| A domain stays on Waiting for DNS | If the verification fails |
| No certificate for a custom domain | Problems with a custom domain |