SubsiMail
Why self-host Pricing Docs Changelog Support FAQ Log in Get started
Log in Get started

← Back to Support

Is there a Docker install guide? First-time setup keeps failing.

#29 Resolved
Steven Y. 324 days ago

Trying to get SubsiMail running via Docker Compose and the container keeps restarting. Log just says database connection refused. Following the quickstart in the docs.

Betty Nguyen Staff 324 days ago

That's almost always a startup-order issue — the app container is trying to connect before the database container is actually ready to accept connections yet, especially on a first run where the DB image also needs to initialize. Does your docker-compose.yml have a depends_on with a healthcheck condition on the db service, or just a plain depends_on? A plain one only waits for the container to start, not for the database itself to be ready inside it.

Steven Y. 324 days ago

Just a plain depends_on, no healthcheck. Added one with a pg_isready check and restarted — that fixed it, app comes up clean now.

Betty Nguyen Staff 324 days ago

Glad that sorted it — that's a common enough gotcha that we should probably add the healthcheck to our example compose file by default. Thanks for flagging it.

This ticket has been resolved. Its author or SubsiMail staff can reopen it to reply further.

Other tickets

Resolved Getting logged out constantly after I reset my password
Robert J. 2 replies
Resolved License renewal failed, card was declined
Susan L. 3 replies
Resolved How do I delete my account and all associated data?
Susan L. 1 reply
Closed DKIM check keeps failing on Namecheap too
Lisa T. 2 replies
Resolved Can I enable two-factor authentication for my account?
Justin C. 1 reply

SubsiMail

The self-hosted alternative to Mailshake.

Documentation Setup guides Changelog Support Pricing Affiliates Terms of Service Privacy Policy Sitemap

Compare

vs. Instantly vs. Smartlead vs. lemlist vs. Apollo

Solutions

For agencies For recruiters

© 2026 SubsiMail.

We use Google Analytics to understand traffic to this site. It only runs if you accept -- see our Privacy Policy.