Configuration
This page covers the core configuration options for your BadgerPanel installation.
Environment and Secrets
BadgerPanel uses HashiCorp Vault for secret management. Sensitive values such as database passwords, API keys, and encryption keys are stored and managed securely by the BadgerPanel infrastructure. You do not need to manage Vault directly - it is configured automatically during installation.
If you need to rotate secrets or have questions about secret management, contact BadgerPanel support.
Environment File
The .env file in your installation directory (~/badgerpanel/.env) contains configuration values that control how the panel operates. Below are the key settings:
| Variable | Description |
|---|---|
APP_URL | The full URL of your panel (e.g., https://panel.example.com). Must match your domain and SSL setup. |
LICENSE_KEY | Your BadgerPanel license key. Do not change this unless instructed by support. |
TIMEZONE | The default timezone for the panel (e.g., America/New_York). |
Most settings are configured automatically during installation. Only edit the .env file if you need to change your panel URL or timezone.
Applying Configuration Changes
After making changes to the .env file, restart the panel services for the changes to take effect:
cd ~/badgerpanel
docker compose down
docker compose up -dThis will briefly take the panel offline while services restart. Active game servers on your nodes are not affected by a panel restart.
Other Settings
Many panel settings are managed through the admin interface rather than the .env file:
- Nodes - Add, remove, and configure game server nodes under Admin > Nodes
- Eggs - Manage game server templates under Admin > Eggs
- Users - Manage user accounts and permissions under Admin > Users
- Database Hosts - Configure external database servers under Admin > Database Hosts
- System Settings - View system information and check for updates under Admin > System
See the relevant documentation pages for details on each area.