Environment Variables

Fresh

Source: bible/setup.md (Step 3 Configure .env)

Full .env reference for Ghost Engine.

Server

Var	Default	Description
GHOST_ENGINE_PORT	4700	HTTP server port
GHOST_ENGINE_API_KEY	ghost-engine-key	API key required in x-api-key header

Encryption

Var	Default	Description
MINI_ENGINE_KEY	machine-derived	32-char encryption key. Used for cookies, fingerprints, passwords (AES-256-GCM)

CAPTCHA solver

Var	Default	Description
CAPTCHA_SERVICE	unset	One of: 2captcha, anticaptcha, capmonster, deathbycaptcha
CAPTCHA_API_KEY	unset	API key for the service

Vision provider (ghost mode)

Var	Default	Description
VISION_PROVIDER	unset	One of: claude, ollama, openai
ANTHROPIC_API_KEY	unset	For Claude provider
OPENAI_API_KEY	unset	For OpenAI provider
OLLAMA_URL	http://127.0.0.1:11434	Ollama endpoint
OLLAMA_VISION_MODEL	llava	Ollama model name

Storage paths

Var	Default	Description
GHOST_FINGERPRINT_DIR	./data/mini-engine-v2/fingerprints	Encrypted fingerprint store
MINI_ENGINE_COOKIE_DIR	./data/mini-engine/cookies	Encrypted cookie jars

Notifications (Discord)

Var	Description
DISCORD_WEBHOOK_COOKIE_FAILURES	Webhook for cookie refresh failures
DISCORD_WEBHOOK_RANK_CHANGES	Webhook for rank movement alerts
DISCORD_WEBHOOK_CAMPAIGN_COMPLETION	Campaign finished
DISCORD_WEBHOOK_ERRORS	Critical errors
DISCORD_WEBHOOK_HEALTH_ALERTS	Account health drops

Content gen

Var	Description
GOOGLE_GEMINI_API_KEY	Gemini content generation
OLLAMA_URL	Local content gen backend

Example .env

# Server
GHOST_ENGINE_PORT=4700
GHOST_ENGINE_API_KEY=ghost-engine-key

# Vision (required for ghost mode)
VISION_PROVIDER=claude
ANTHROPIC_API_KEY=sk-ant-...

# Captcha
CAPTCHA_SERVICE=2captcha
CAPTCHA_API_KEY=...

# Notifications
DISCORD_WEBHOOK_COOKIE_FAILURES=https://discord.com/api/webhooks/...
DISCORD_WEBHOOK_RANK_CHANGES=https://discord.com/api/webhooks/...

Required for ghost mode

At minimum:

• VISION_PROVIDER
• One matching API key

Required for CAPTCHA bypass

• CAPTCHA_SERVICE
• CAPTCHA_API_KEY

Required for basic CTR operation

Nothing. Defaults work for everything except ghost mode and CAPTCHA-protected pages.