# n8n-debugger Environment Configuration # Copy this file to .env and fill in your values # ============================================================================= # Core n8n Configuration (Required for all modes) # ============================================================================= # Your n8n instance URL # Must include protocol (https://) and trailing slash # Example: https://n8n.seibert.tools/ N8N_BASE_URL=https://your-n8n-instance.com/ # Your n8n API key (get from n8n Settings → API) # Required in development mode # Optional in production (user-specific keys stored in Secret Manager) N8N_API_KEY=your-api-key-here # Optional: Filter workflows by project ID (for n8n cloud instances) # Leave empty if using self-hosted n8n or want to see all workflows N8N_PROJECT_ID= # ============================================================================= # Web UI Authentication (Required for Production Only) # ============================================================================= # Secret key for signing JWT tokens # Must be a long, random string (minimum 32 characters recommended) # Generate with: openssl rand -base64 32 # NEVER commit this to version control! JWT_SECRET= # Google OAuth 2.0 Client ID # Get from: Google Cloud Console → APIs & Services → Credentials GOOGLE_CLIENT_ID= # Google OAuth 2.0 Client Secret # Get from: Google Cloud Console → APIs & Services → Credentials # NEVER commit this to version control! GOOGLE_CLIENT_SECRET= # Express session secret # Used temporarily during OAuth flow (sessions expire after 10 minutes) # Generate with: openssl rand -base64 32 # Auto-generated in development if not provided SESSION_SECRET= # ============================================================================= # Server Configuration (Optional) # ============================================================================= # Environment mode: development or production # Defaults to production if not set # Development mode disables OAuth and uses N8N_API_KEY directly NODE_ENV=development # Port for web UI server # Default: 8080 PORT=8080 # ============================================================================= # Google Cloud Configuration (Production Only) # ============================================================================= # Google Cloud project ID for Vertex AI and Secret Manager # Default: jopnelli-dev GOOGLE_CLOUD_PROJECT=jopnelli-dev # Google Cloud region for Vertex AI # Default: europe-west3 # Choose region closest to your users for best latency GOOGLE_CLOUD_LOCATION=europe-west3 # ============================================================================= # Quick Start Guides # ============================================================================= # Development Setup (Minimal): # 1. Copy this file: cp .env.example .env # 2. Set these required variables: # - NODE_ENV=development # - N8N_BASE_URL=https://your-n8n-instance.com/ # - N8N_API_KEY=your-api-key-here # 3. Run: cd packages/web && npm run dev # Production Setup: # 1. Copy this file: cp .env.example .env # 2. Set all production-required variables (see above) # 3. Configure Google Cloud Secret Manager # 4. Deploy to Cloud Run # 5. See AGENTS.md for complete setup instructions