diff --git a/agent-os/studio/introduction.mdx b/agent-os/studio/introduction.mdx
index 631c2926..ffad9dd8 100644
--- a/agent-os/studio/introduction.mdx
+++ b/agent-os/studio/introduction.mdx
@@ -20,29 +20,36 @@ Studio connects to your running AgentOS instance and uses a Registry to populate
 Build visually, test interactively, and publish when ready.
 
 1. Register your components in a `Registry`
-2. Pass the registry to `AgentOS`
+2. Pass the registry **and a database** to `AgentOS`
 3. Open Studio in the control plane to start building
 
 ```python
 from agno.os import AgentOS
+from agno.db.postgres import PostgresDb
 from agno.registry import Registry
 from agno.models.openai import OpenAIChat
 from agno.tools.websearch import WebSearchTools
 
+db = PostgresDb(db_url="postgresql+psycopg://ai:ai@localhost:5532/ai")
+
 registry = Registry(
     name="My Registry",
     tools=[WebSearchTools()],
     models=[OpenAIChat(id="gpt-5-mini")],
+    dbs=[db],
 )
 
 agent_os = AgentOS(
     id="my-app",
+    db=db,
     registry=registry,
 )
 
 app = agent_os.get_app()
 ```
 
+<Warning> The `db` parameter is required for Studio's `/components` API endpoints to be available. Without it, Studio cannot save or load agents, teams, and workflows.</Warning>
+
 ## Development Lifecycle
 
 Studio manages the full development lifecycle from building to deploying complex agentic systems with AgentOS components.