Setup Wizard

When you first install STING, a browser-based setup wizard launches at http://localhost:8335. This wizard walks you through the essential configuration steps so you don’t need to manually edit config files.

Launching the Wizard

The wizard starts automatically during installation. If you need to re-run it:

sudo msting start web-setup

Then open http://localhost:8335 in your browser.

Configuration Steps

The wizard consists of 9 steps:

Step 1: Welcome & System Check

Verifies your system meets minimum requirements:

• Docker and Docker Compose installed
• Sufficient RAM (8 GB minimum, 16 GB+ recommended)
• Adequate disk space (50 GB minimum)
• Required ports available

Step 2: Hostname & Domain

Configure how STING is accessed:

• Hostname — your domain (e.g., sting.company.com) or localhost for local dev
• Frontend port — default 8443 (or 443 with reverse proxy)
• SSL mode — self-signed (dev), Let’s Encrypt (production), or custom certificates

Step 3: Database

PostgreSQL configuration:

• Database passwords are auto-generated and stored in Vault
• Three databases are created: sting_app, kratos_db, sting_messaging
• Connection pooling settings

Step 4: Authentication

Ory Kratos identity configuration:

• Admin account email and credentials
• SMTP settings for email verification and recovery
• WebAuthn/passkey configuration (RP ID, display name)
• MFA enforcement policy

Step 5: AI Model Configuration

Configure your LLM provider:

• Provider selection — Ollama (local), OpenAI, MiniMax, Anthropic, vLLM
• Endpoint — hostname and port for local providers
• API keys — securely stored in Vault
• Default model — which model to use for Bee AI

Step 6: Email / SMTP

Email delivery for notifications and account recovery:

• SMTP server, port, and credentials
• Sender address and display name
• Test email functionality
• Mailpit option for development (port 8025)

Step 7: Storage & Uploads

File storage configuration:

• Upload size limits
• Storage backend (local filesystem or S3-compatible)
• Profile image settings

Step 8: Hive Mode (Optional)

Enable ChatOps platform connectors:

• Platform selector — Slack, Microsoft Teams, Discord
• Bot credentials — tokens, app IDs, webhook URLs per platform
• Channel configuration — which channels the bot monitors
• Enable/disable per-platform

Step 9: Review & Deploy

Final review of all settings before deployment:

• Summary of all configuration choices
• Option to go back and edit any step
• Deploy button generates all env files, starts services, and runs initial setup

After the Wizard

Once the wizard completes:

1. All configuration is written to conf/config.yml
2. Environment files are generated in env/
3. Kratos identity config is generated
4. All Docker services are started
5. The wizard service stops automatically

You can now access STING at your configured hostname.

Re-configuring After Setup

The wizard is designed for first-run only. For subsequent changes:

# Edit the master config
sudo nano /opt/sting-ce/conf/config.yml

# Regenerate environment files
sudo msting regenerate-env

# Or reset to defaults
sudo msting reset-config

Individual settings can also be changed through the STING admin UI once logged in.