Getting StartedDeployingCustom DomainsEnvironment VariablesDatabaseAddonsEnergy & BoostsCLI ReferenceAPI ReferenceMCP Integration

Energy & Boosts

How runtime budgets, boosts, and always-on work for your eggs.

Energy system

Every free egg has a daily and weekly energy budget. Energy is consumed while your egg is running. When energy runs out, the egg sleeps until the next reset.

Static eggs (deployed with --runtime static) are always free and never consume energy. They don't count toward the 3-egg limit.

API and webhook requests always wake sleeping eggs regardless of energy budget. Only browser visitors see the out-of-energy page.

Daily budget2 hours of runtime per day (resets at midnight UTC)
Weekly budget8 hours of runtime per week (resets Monday at midnight UTC)
Idle sleepDynamic eggs sleep after 3 min idle, static eggs after 30 min (wakes on next request)

Check energy status

See your account-wide or per-egg energy usage from the CLI:

# Account-wide energy status
hatch energy

# Per-egg energy status
hatch energy my-egg-xxxx

You can also see energy status on the dashboard for each egg.

Boosts

Need your egg to keep running without energy limits? Buy a boost — a one-time purchase with no subscription.

Day boost€1 — 24 hours of uninterrupted runtime, no sleep, no energy limits
Week boost€3 — 7 days of uninterrupted runtime, no sleep, no energy limits
# Boost for a day
hatch boost my-egg-xxxx day

# Boost for a week
hatch boost my-egg-xxxx week

Boosts are per-egg. You can stack them — boost as many eggs as you need.

Always On

For production apps that need 24/7 reliability, subscribe to Always On at €10/month per egg.

Never sleeps — runs continuously 24/7
No energy limits
1 GB RAM per egg (vs 256 MB free)
Dedicated PostgreSQL (1 GB storage)
Cancel anytime

Subscribe from the dashboard egg detail page, or see Pricing for full details.

What happens when energy runs out?

When your egg exhausts its daily or weekly energy:

  1. 1The egg is put to sleep by the platform
  2. 2Visitors see a "sleeping" page with a countdown to the next energy reset
  3. 3When energy resets (daily at midnight UTC, weekly on Monday), the egg can wake again
  4. 4Or buy a boost to wake it immediately and bypass energy limits
Hatch mascot