Learning Hub
← System Design & Architecture

Stateful vs stateless services

6 min readΒ·Updated 2026-09-09

A stateless service can handle the next request on any equivalent instance using external state; a stateful service owns durable or session state that affects placement, scaling, and recovery.

A stateless service can handle the next request on any equivalent instance using external state; a stateful service owns durable or session state that affects placement, scaling, and recovery.

At a glance

Question Practical answer
When is it useful? In a small real-world scenario, draw the parts involved, follow one request or decision from start to finish, and mark the evidence produced at each step.
What should you do? Classify an API, database, cache, and WebSocket session; restart an instance and explain exactly which state survives, moves, or disappears.
How do you know it worked? The result can be repeated from your notes, and each important claim is supported by an output, measurement, query result, or reviewable artifact.
Common failure A common mistake is choosing a tool or pattern before stating the problem, constraints, and success measure.
flowchart LR
  A[Question] --> B[Stateful vs stateless services]
  B --> C[Small example]
  C --> D[Evidence]

The important idea is not to stop at a definition: connect the concept to a small example and observable evidence.

Worked example

In a small real-world scenario, draw the parts involved, follow one request or decision from start to finish, and mark the evidence produced at each step.

Before acting, write the success signal. Change one condition at a time, observe the result, and record assumptions. For Stateful vs stateless services, this separates what you know from what you are merely guessing.

Practice in 20–30 minutes

Goal: Classify an API, database, cache, and WebSocket session; restart an instance and explain exactly which state survives, moves, or disappears.

  1. Record the starting state and your prediction.
  2. Implement the smallest version without adding unnecessary tools.
  3. Change exactly one input or constraint and repeat.
  4. Save a command, screenshot, output, or checklist as evidence.

Expected result: The result can be repeated from your notes, and each important claim is supported by an output, measurement, query result, or reviewable artifact.

What can go wrong

A common mistake is choosing a tool or pattern before stating the problem, constraints, and success measure.

When the result differs from your prediction, do not change many things at once. Check inputs, versions, environment, permissions, and logs, then repeat from the smallest example.

Definition of done

  • I can explain the concept in my own words.
  • I completed the small example and kept evidence.
  • I know one failure mode and how to check it.
  • Someone else can repeat the work without guessing missing steps.

Go deeper

Use the linked resource or repository at the end of the page when you need a full implementation. Check current versions before applying commands to a real project.