nexus/.env.example at develop · nexi-lab/nexus · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
# ============================================
# PostgreSQL Database
# ============================================
POSTGRES_DB=nexus
POSTGRES_USER=postgres
POSTGRES_PASSWORD=nexus
POSTGRES_PORT=5432
POSTGRES_HOST=postgres
# NOTE: Both local-demo.sh and docker-demo.sh share the same PostgreSQL container
#   - For local-demo.sh: Add to /etc/hosts: 127.0.0.1 postgres
#     Or use POSTGRES_HOST=localhost (will auto-fallback if 'postgres' not in /etc/hosts)
#   - For docker-demo.sh: Uses 'postgres' directly (Docker internal networking)
#   - Production: Set to actual database hostname or 'postgres' for Docker deployment

# NOTE: TOKEN_MANAGER_DB is automatically constructed by docker-compose.yml
#       from the variables above. You don't need to set it manually.

# ============================================
# Nexus Server
# ============================================
NEXUS_PORT=2026

# Nexus Server URL (used in agent configs and client connections)
# Set this to your actual Nexus server URL for production deployments
# Examples:
#   - Local: http://localhost:2026
#   - Docker: http://nexus:2026
#   - Production: https://your-nexus-server.com
#   - LangGraph Cloud: https://nexus-agent-xxxxxx.us.langgraph.app
NEXUS_SERVER_URL=http://localhost:2026

# LangGraph Server URL (used in agent configs)
# Set this if you're running a custom LangGraph server
# Default: http://localhost:2024
LANGGRAPH_SERVER_URL=http://localhost:2024

# ============================================
# Production Deployment (Optional - GCP Docker)
# ============================================
# Uncomment and set these for production deployment with SSL:
# DOMAIN=nexus-server.nexilab.co
# SSL_EMAIL=admin@nexilab.co

# ============================================
# MCP Server (Model Context Protocol)
# ============================================
MCP_PORT=8081

# Transport Mode: stdio (local/Claude Desktop) or http (remote/web)
# stdio: For Claude Desktop integration (local only)
# http: For remote access, web clients, production deployment
MCP_TRANSPORT=http

# Backend Connection for MCP Server
# Option 1: Connect to nexus-server (recommended for production)
NEXUS_URL=http://nexus-server:2026
# Use same API key as nexus-server

# Option 2: Local embedded mode (comment out NEXUS_URL above)
# Uses local filesystem without separate backend server
# NEXUS_BACKEND=local
# NEXUS_DATA_DIR=/app/data

# Database URL (uses PostgreSQL service)
# Auto-generated: postgresql://postgres:nexus@postgres:5432/nexus
# Override if needed:
# NEXUS_DATABASE_URL=postgresql://postgres:nexus@postgres:5432/nexus

# Authentication
# Leave empty to auto-generate admin API key on first run
# Or provide your own (format: sk-<prefix>_<username>_<uuid>_<hash>):
NEXUS_API_KEY=sk-default_admin_dddddddd_eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

# OAuth Encryption Key (for secure token storage)
# Generate with: python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
# IMPORTANT: Use the same key for both local CLI and Docker server!
# NEXUS_OAUTH_ENCRYPTION_KEY=your-encryption-key-here

# Backend Storage
# Options: local (default), gcs (Google Cloud Storage)
NEXUS_BACKEND=local

# GCS Backend (only if NEXUS_BACKEND=gcs)
# NEXUS_GCS_BUCKET=your-bucket-name
# NEXUS_GCS_PROJECT=your-gcp-project-id
# GCS_CREDENTIALS_PATH=/path/to/gcs-credentials.json
# GOOGLE_APPLICATION_CREDENTIALS=/app/gcs-credentials.json

# ============================================
# LangGraph Agent Server
# ============================================
LANGGRAPH_PORT=2024

# LLM API Keys (REQUIRED for LangGraph - at least one must be set)
ANTHROPIC_API_KEY=
# Optional alternatives
OPENAI_API_KEY=
GOOGLE_API_KEY=

# Optional: Additional Tool API Keys
TAVILY_API_KEY=
E2B_API_KEY=
FIRECRAWL_API_KEY=

# LangSmith tracing (optional)
LANGCHAIN_TRACING_V2=false
LANGCHAIN_ENDPOINT=https://api.smith.langchain.com
LANGCHAIN_PROJECT=
LANGSMITH_API_KEY=

# ============================================
# Frontend
# ============================================
FRONTEND_PORT=5173

# Backend API URLs
# For local development (browser access):
VITE_NEXUS_API_URL=http://localhost:2026
VITE_LANGGRAPH_API_URL=http://localhost:2024

# For Docker internal routing (container-to-container):
# VITE_NEXUS_API_URL=http://nexus:2026
# VITE_LANGGRAPH_API_URL=http://langgraph:2024
VITE_NEXUS_SERVER_URL=http://nexus:2026

# Permission and Authentication Settings
NEXUS_SKIP_PERMISSION=false
VITE_SKIP_AUTH=false

NEXUS_OAUTH_GOOGLE_CLIENT_ID=
NEXUS_OAUTH_GOOGLE_CLIENT_SECRET=