Setup & Configuration

Getting Started

WolfHost is built into WolfStack and free on every tier — there is nothing separate to install, license, or download. Open WolfHost from the WolfStack sidebar and set your company name, branding, currency, and portal port from the admin panel.

Your customers reach their self-service portal on the portal port (default 8443); the admin panel lives inside the WolfStack dashboard. Websites, email, databases, DNS, SSL and every hosting tool run natively on your own cluster containers — no third-party control panel required.

Configuration

Setting	Default	Description
portal_port	8443	Port for the customer self-service portal
api_port	9200	Internal admin API port
company_name	My Hosting	Your hosting company name shown in the customer portal
currency	USD	Default currency for billing (USD, EUR, GBP, CAD, AUD)

Database Configuration

Optionally connect to a central MySQL/MariaDB server for customer databases. Configure from the admin panel with a built-in connection test:

Setting	Default	Description
db.host	127.0.0.1	Database server hostname
db.port	3306	Database server port
db.username	root	Database admin username
db.database	wolfhost	WolfHost metadata database name

WolfHost stores its data under /etc/wolfstack/ as JSON files. The database server is optional and used for customer databases only.

Technical Details

• Backend — Rust (Actix-web 4), compiles to a single static binary (bin/handler)
• Storage — JSON file-based data store for config and metadata (no database dependency for core data)
• Database — sqlx for MySQL/MariaDB connectivity; optional central database server for customer databases
• Container provisioning — auto-detects Proxmox (pct) vs native LXC (lxc-create/lxc-attach). Full LAMP stack setup with PHP modules, mod_rewrite, mod_ssl, Certbot, vsftpd, MariaDB client
• Reverse proxy — automatic Nginx configuration per container with ACME passthrough, WebSocket support, and proper header forwarding (X-Real-IP, X-Forwarded-For, X-Forwarded-Proto)
• Mail server — full Postfix + Dovecot + DKIM installation with automatic SPF, DKIM, and DMARC DNS record generation
• Cluster integration — communicates with WolfStack via X-WolfStack-Secret header for node listing, container creation, and Proxmox guest actions
• App installer — 12 apps installed inside customer containers via pct exec or lxc-attach with automatic database provisioning
• Authentication — admin access through WolfStack auth; customer portal uses Argon2 password hashing with session tokens and optional TOTP two-factor authentication
• Live streaming — Server-Sent Events (SSE) for real-time provisioning log output
• Architecture — the admin panel is built into the WolfStack dashboard; the customer portal runs as its own server (port 8443, direct access) so untrusted customer traffic stays isolated from the core