Skip to main content

Configuration Reference (.env)

Every aspect of the MCP stack is controlled through the .env file. Copy .env.example to .env and fill in your values.

Server Connectivity​

VariableRequiredDefaultDescription
UBUNTU_SERVER_HOSTYes—Hostname or IP of your Ubuntu server
UBUNTU_SERVER_SSH_PORTNo22SSH port on the server
UBUNTU_SERVER_USERYes—SSH username for connecting

Example:

UBUNTU_SERVER_HOST=myserver.example.com
UBUNTU_SERVER_SSH_PORT=22
UBUNTU_SERVER_USER=alice

Container Names​

VariableRequiredDefaultDescription
UBUNTU_MCP_CONTAINERNoubuntu-mcpDocker container name for Ubuntu MCP
OBSIDIAN_MCP_CONTAINERNoobsidian-mcpDocker container name for Obsidian MCP
SYNOLOGY_MCP_CONTAINERNosynology-mcpDocker container name for Synology MCP
GITHUB_MCP_CONTAINERNogithub-mcpDocker container name for GitHub MCP

Synology NAS (DSM 7.x)​

These variables configure the Synology MCP connection. The NAS must be on the same LAN as the Ubuntu server or reachable over the network.

VariableRequiredDefaultDescription
SYNOLOGY_NAS_HOSTYes192.168.1.100IP address or hostname of your Synology NAS
SYNOLOGY_NAS_PORTNo5001DSM HTTPS port
SYNOLOGY_NAS_USERYes—DSM login username
SYNOLOGY_NAS_PASSWORDYes—DSM login password
SYNOLOGY_NAS_OTP_SECRETNo—Base32 TOTP secret if 2FA is enabled. Copy only the secret= value from your otpauth:// URL. Leave empty if 2FA is disabled.

Example:

SYNOLOGY_NAS_HOST=192.168.1.100
SYNOLOGY_NAS_PORT=5001
SYNOLOGY_NAS_USER=admin
SYNOLOGY_NAS_PASSWORD=your-secure-password
SYNOLOGY_NAS_OTP_SECRET=JBSWY3DPEHPK3PXP

Obsidian​

VariableRequiredDefaultDescription
OBSIDIAN_VAULT_PATHYes—Path to your Obsidian vault on the host. Mounted read-write so the MCP can read and edit notes.
OBSIDIAN_LIVESYNC_DATANo—Path to Obsidian Live Sync CouchDB data (if using Live Sync).

Example:

OBSIDIAN_VAULT_PATH=/DATA/obsidian-vaults/personal
OBSIDIAN_LIVESYNC_DATA=/DATA/AppData/big-bear-obsidian-livesync/data

Web UI​

VariableRequiredDefaultDescription
WEBUI_API_KEYYes—API key for Web UI login. Generate with bash scripts/generate-api-key.sh. Must be a strong random 64-char hex string.
WEBUI_AUTH_SECRETYes—Session encryption secret. Generate with openssl rand -hex 32.
WEBUI_PORTNo8280Host port for the Web UI.
WEBUI_IMAGE_TAGNolatestDocker image tag for the Web UI.

Generating secrets:

# Generate API key
bash scripts/generate-api-key.sh

# Generate auth secret
openssl rand -hex 32

Copy both outputs into your .env file.

Documentation Site​

VariableRequiredDefaultDescription
DOCS_PORTNo3000Host port for the Docusaurus docs site.
DOCS_IMAGE_TAGNolatestDocker image tag for the docs site.

Docker Image Tags​

VariableRequiredDefaultDescription
UBUNTU_MCP_IMAGE_TAGNolatestTag for Ubuntu MCP image
OBSIDIAN_MCP_IMAGE_TAGNolatestTag for Obsidian MCP image
SYNOLOGY_MCP_IMAGE_TAGNolatestTag for Synology MCP image
GITHUB_MCP_IMAGE_TAGNolatestTag for GitHub MCP image

For production, pin specific version tags instead of latest.

External MCP Tokens​

VariableRequiredDefaultDescription
GITHUB_TOKENNo—GitHub personal access token. Create at GitHub → Settings → Developer settings → Personal access tokens. Required for GitHub MCP functionality.

Logging​

VariableRequiredDefaultDescription
MCP_LOG_DIRNo/var/log/mcpDirectory for MCP audit and application logs. Subdirectories are created per server (ubuntu, obsidian, synology, github).
MCP_LOG_LEVELNoINFOLog level for all MCP servers. Options: DEBUG, INFO, WARNING, ERROR.

Example:

MCP_LOG_DIR=/var/log/mcp
MCP_LOG_LEVEL=INFO

Full Example​

# Server Connectivity
UBUNTU_SERVER_HOST=myserver.example.com
UBUNTU_SERVER_SSH_PORT=22
UBUNTU_SERVER_USER=alice

# Synology NAS
SYNOLOGY_NAS_HOST=192.168.1.100
SYNOLOGY_NAS_PORT=5001
SYNOLOGY_NAS_USER=admin
SYNOLOGY_NAS_PASSWORD=secure-password-here
SYNOLOGY_NAS_OTP_SECRET=

# Obsidian
OBSIDIAN_VAULT_PATH=/DATA/obsidian-vaults/personal
OBSIDIAN_LIVESYNC_DATA=/DATA/AppData/big-bear-obsidian-livesync/data

# Web UI
WEBUI_API_KEY=a1b2c3d4e5f6...64-char-hex
WEBUI_AUTH_SECRET=f7e8d9c0...32-byte-hex
WEBUI_PORT=8280

# Docs
DOCS_PORT=3000

# Docker Tags
UBUNTU_MCP_IMAGE_TAG=latest
OBSIDIAN_MCP_IMAGE_TAG=latest
SYNOLOGY_MCP_IMAGE_TAG=latest
GITHUB_MCP_IMAGE_TAG=latest

# GitHub
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx

# Logging
MCP_LOG_DIR=/var/log/mcp
MCP_LOG_LEVEL=INFO