SubsiMail
Why self-host Pricing Docs Support FAQ Log in Get a license
Log in Get a license

← Back to Support

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

#29 Resolved
Steven Y. 279 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 279 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. 279 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 279 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 How many contacts can I import before hitting a limit?
David B. 1 reply
Resolved Can I connect an Outlook/Office 365 account instead of Gmail?
Elizabeth H. 1 reply
Resolved What's a safe daily sending volume for a brand-new domain?
Ashley D. 1 reply
Resolved Refund policy if self-hosting doesn't work out for us?
Elizabeth H. 1 reply
Resolved License renewal failed, card was declined
Susan L. 3 replies

SubsiMail

The self-hosted alternative to Mailshake.

Documentation Setup guides Support Pricing Terms of Service Privacy Policy Sitemap

© 2026 SubsiMail.

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