Skip to content
  • Home
  • About
  • No Access
  • Privacy Policy
Bits of .NET
Bits of .NET
  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy

Bits of .NET

Daily micro-tips for C#, SQL, performance, and scalable backend engineering.

  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy
Docker

Docker: Fix a Compose File Where One Service Starts Before Its Dependency Is Ready

- 06.09.26 - ErcanOPAK

🐳 Your App Container Starts Before the Database It Depends On Is Actually Ready

A `docker-compose.yml` lists the database as a `depends_on` dependency of the app service, and the app still fails on startup trying to connect to a database that’s technically running but not yet ready to accept connections – because Compose’s `depends_on` by default only waits for the dependency’s CONTAINER to start, not for whatever’s running inside it to actually finish its own startup and become ready.

🔎 The Problem

services:
  app:
    build: .
    depends_on:
      - db          # only waits for the db CONTAINER to start
  db:
    image: postgres:16

# Postgres'"'"'s container process starts almost immediately, but the
# actual database engine inside it still takes a few seconds to
# initialize before it'"'"'s ready to accept connections. `depends_on`
# in this basic form only guarantees START ORDER of the containers -
# it says nothing about whether the service inside db is actually
# ready to be talked to yet.

✅ Fix: Use a Healthcheck-Based Condition

  • Add a `healthcheck` to the dependency service, and use the `condition: service_healthy` form of `depends_on` on the dependent service – this makes Compose actually wait for the healthcheck to pass (i.e., the database confirms it’s ready) before starting the app, not just for the container process to exist.
  • For Postgres specifically, a healthcheck using `pg_isready` (`test: [“CMD-SHELL”, “pg_isready -U postgres”]`) is the standard, reliable way to detect real readiness – equivalent readiness checks exist for MySQL, Redis, and most common dependency images.

⚠️ The Belt-and-Suspenders Approach

  • Even with a proper healthcheck-based `depends_on`, it’s still good practice for the app itself to implement its own retry-with-backoff logic on startup for its database connection – this protects against the healthcheck itself being imperfect, and against the SAME issue happening later if the database restarts independently while the app keeps running.

depends_on getting the container running isn’t the same as the service inside it being ready to talk – those are two different moments, and only one of them is what your app actually needs to wait for.

— DevOps Engineer

Related posts:

Docker: Manage Container Lifecycle — Start, Stop, Restart

Docker: Manage Container Lifecycle — Start, Stop, Restart

Docker Containers Restart in a Loop

Docker Containers Restart in a Loop

Docker: Fix a Bind-Mounted File That Silently Shows Different Ownership and Permissions Inside the C...

Docker: Fix a Bind-Mounted File That Silently Shows Different Ownership and Permissions Inside the C...

Views: 6

Post navigation

HTML5: Fix a Date Input Showing a Different Format Than What You Send the Server
SQL Server: Why NULL Values Break a Simple NOT IN Subquery

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

November 2026
M T W T F S S
 1
2345678
9101112131415
16171819202122
23242526272829
30  
« Oct    

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (977)
  • Get the First and Last Word from a String or Sentence in SQL (858)
  • How to select distinct rows in a datatable in C# (854)
  • How to enable, disable and check if Service Broker is enabled on a database in SQL Server (653)
  • Add Constraint to SQL Table to ensure email contains @ (609)
  • Average of all values in a column that are not zero in SQL (570)
  • How to use Map Mode for Vertical Scroll Mode in Visual Studio (547)
  • Find numbers with more than two decimal places in SQL (475)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit
  • SQL Server: Fix ROW_NUMBER Ties Reordering Between Identical Runs
  • C#: Fix an Enum HasFlag Returning True for the Zero Value
  • WordPress: Fix Featured Images Vanishing After a CDN Migration
  • Photoshop: Fix Content-Aware Fill Smearing a Repeating Pattern
  • Asp.Net Core: Fix Antiforgery Tokens Rejected Behind a Reverse Proxy

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (977)
  • Get the First and Last Word from a String or Sentence in SQL (858)
  • How to select distinct rows in a datatable in C# (854)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit

Social

  • ErcanOPAK.com
  • GoodReads
  • LetterBoxD
  • Linkedin
  • The Blog
  • Twitter
© 2026 Bits of .NET | Built with Xblog Plus free WordPress theme by wpthemespace.com