diff --git a/.env.example b/.env.example
index 18aaa5a..ad3e00c 100644
--- a/.env.example
+++ b/.env.example
@@ -15,7 +15,7 @@ PORT=3000
 # APPVIEW_DID=did:web:api.bsky.app
 
 # Optional: Relay for firehose
-# RELAY_HOST=https://bsky.network
+# RELAY_URL=https://bsky.network
 
 # Cloudflare-specific (not needed for Node.js)
 # CLOUDFLARE_API_TOKEN=your_api_token_here
diff --git a/README.md b/README.md
index 886daa2..7b69e44 100644
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@ npm run setup -- --pds https://localhost:3443 --plc-url http://localhost:2582 --
 | HOSTNAME | No | Public hostname for the PDS |
 | APPVIEW_URL | No | AppView URL for proxying |
 | APPVIEW_DID | No | AppView DID for service auth |
-| RELAY_HOST | No | Relay URL for firehose notifications |
+| RELAY_URL | No | Relay URL for firehose notifications |
 
 ## Deploy: Node.js
 
diff --git a/docs/plans/2026-01-11-e2e-local-relay-integration.md b/docs/plans/2026-01-11-e2e-local-relay-integration.md
index 4553114..8a126b7 100644
--- a/docs/plans/2026-01-11-e2e-local-relay-integration.md
+++ b/docs/plans/2026-01-11-e2e-local-relay-integration.md
@@ -4,7 +4,7 @@
 
 **Goal:** Integrate local PLC and relay from docker-compose into e2e tests for debugging sync issues and comprehensive federation testing.
 
-**Architecture:** Tests use a hybrid docker management approach - check if services are running, start them if not, reset volumes for clean state. The Node.js PDS is configured with `relayHost` to notify the local relay after commits. New test suite verifies events flow through the relay correctly.
+**Architecture:** Tests use a hybrid docker management approach - check if services are running, start them if not, reset volumes for clean state. The Node.js PDS is configured with `relayUrl` to notify the local relay after commits. New test suite verifies events flow through the relay correctly.
 
 **Tech Stack:** Docker Compose, Vitest, Node.js `child_process` for docker management, WebSocket for firehose tests.
 
@@ -175,7 +175,7 @@ git commit -m "feat: add docker services helper for e2e tests"
 **Files:**
 - Modify: `test/helpers/node-server.js`
 
-**Step 1: Add USE_LOCAL_INFRA constant and relayHost config**
+**Step 1: Add USE_LOCAL_INFRA constant and relayUrl config**
 
 Replace the entire file with:
 
@@ -206,7 +206,7 @@ export async function startNodeServer() {
     hostname: USE_LOCAL_INFRA ? 'host.docker.internal:3000' : `localhost:${TEST_PORT}`,
     password: 'test-password',
     // Use local relay when docker infrastructure is available
-    relayHost: USE_LOCAL_INFRA ? 'localhost:2470' : undefined,
+    relayUrl: USE_LOCAL_INFRA ? 'localhost:2470' : undefined,
     // Keep appview pointing to production (for proxy tests)
     appviewUrl: 'https://api.bsky.app',
     appviewDid: 'did:web:api.bsky.app',
diff --git a/docs/plans/2026-01-11-subscribe-repos-websocket.md b/docs/plans/2026-01-11-subscribe-repos-websocket.md
index 886cb84..15ffc2a 100644
--- a/docs/plans/2026-01-11-subscribe-repos-websocket.md
+++ b/docs/plans/2026-01-11-subscribe-repos-websocket.md
@@ -61,7 +61,7 @@ constructor({
   hostname,
   appviewUrl,
   appviewDid,
-  relayHost,
+  relayUrl,
   password,
   webSocket,  // Add this
 }) {
@@ -71,7 +71,7 @@ constructor({
   this.hostname = hostname;
   this.appviewUrl = appviewUrl || BSKY_APPVIEW_URL;
   this.appviewDid = appviewDid;
-  this.relayHost = relayHost;
+  this.relayUrl = relayUrl;
   this.password = password;
   this.webSocket = webSocket;  // Add this
   this.lastCrawlNotify = 0;
@@ -253,7 +253,7 @@ constructor(state, env) {
     hostname: env.HOSTNAME,
     appviewUrl: env.APPVIEW_URL,
     appviewDid: env.APPVIEW_DID,
-    relayHost: env.RELAY_HOST,
+    relayUrl: env.RELAY_URL,
     password: env.PDS_PASSWORD,
   });
 }
@@ -339,7 +339,7 @@ export async function createServer({
   hostname,
   appviewUrl,
   appviewDid,
-  relayHost,
+  relayUrl,
   password,
 }) {
   const Database = (await import('better-sqlite3')).default;
@@ -361,7 +361,7 @@ export async function createServer({
     hostname,
     appviewUrl,
     appviewDid,
-    relayHost,
+    relayUrl,
     password,
   });
 
diff --git a/examples/node/.env.example b/examples/node/.env.example
index 0cc3a15..f5035b8 100644
--- a/examples/node/.env.example
+++ b/examples/node/.env.example
@@ -12,7 +12,7 @@ PORT=3000
 # APPVIEW_DID=did:web:api.bsky.app
 
 # Optional: Relay for firehose
-# RELAY_HOST=wss://bsky.network
+# RELAY_URL=wss://bsky.network
 
 # Optional: Password for createSession
 # PDS_PASSWORD=