Flask app context Python Origin: Application & API Last updated 13 Oct 2026

RuntimeError: Working outside of application context.

Code used current_app, g, or a Flask extension (like SQLAlchemy) without an active Flask application context.

Exact message you may see Working outside of application contextWorking outside of request context
Explore the map of this error Full error map →
Seen on: Python

Meaning

Flask sets up the app context during a request or CLI command. Scripts, background threads, tests and module-level code don’t have one unless you push it.

Common causes

  • db.create_all() or queries in a standalone script
  • Background thread/Celery task using current_app
  • Module-level code accessing current_app

⚡ Quick fix

  1. Wrap the code: with app.app_context(): ...
  2. Pass the app object to background workers
  3. Use Flask CLI commands for maintenance scripts

Detailed fix by platform

Python

  1. python
    with app.app_context():
    db.create_all()

How to diagnose

  1. Where — Request handler, script, thread or test?
  2. Object — Which object needs the context (db, current_app, g)?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Application & API. Errors that are often confused with or caused by this one (click to open):

AttributeError — AttributeError: 'X' object has no attribute 'y' (Python)AttributeErrorConnectionRefusedError — ConnectionRefusedError: [Errno 111] Connection refused (Python)ConnectionRefusedErrorEvent loop is closed — RuntimeError: Event loop is closed (Python)Event loop is closednever awaited — RuntimeWarning: coroutine 'fetch' was never awaited (Python)never awaitedNo QueryClient set — Error: No QueryClient set, use QueryClientProvider to set one (React)No QueryClient setuseContext undefined — TypeError: Cannot destructure property 'user' of 'useContext(...)' as it is undefined. (React)useContext undefineduseNavigate outside Router — Error: useNavigate() may be used only in the context of a <Router> component. (React)useNavigate outside R…Flask app…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.