InfraPilot Docs
Everything you need to install, configure, and operate InfraPilot on your infrastructure.
Quick Start
Get InfraPilot running on your server in under 5 minutes. You need Docker and Docker Compose installed.
1. Run the one-line installer
2. Open the dashboard
Navigate to http://your-server:3000 in your browser. The setup wizard will guide you through the initial configuration.
3. Activate your license
Get a free Community license at infrapilot.org/signup. Enter your license key in the dashboard under Settings → License.
Requirements: Linux server with Docker 20.10+, Docker Compose v2+, and at least 512 MB available RAM.
Installation
Option A: Automated installer (recommended)
curl -fsSL https://infrapilot.sh | bash
Downloads the latest release, creates the directory structure, and starts the stack automatically.
Option B: Manual Docker Compose
# Clone the repository
git clone https://github.com/infrapilothq/infrapilot.git
cd infrapilot
# Copy environment template
cp .env.example .env
# Edit .env and set your values
# Start the stack
docker compose up -d
System requirements
Configuration
InfraPilot is configured through a .env file in the installation directory.
Core environment variables
DATABASE_URLrequiredREDIS_URLrequiredNEXTAUTH_SECRETrequiredNEXTAUTH_URLrequiredSMTP_HOSTSMTP_PORTSMTP_USERSMTP_PASSSTRIPE_SECRET_KEYNginx & SSL
InfraPilot manages Nginx configuration through its visual interface. To expose your dashboard over HTTPS, add a reverse proxy entry pointing to localhost:3000 and enable Let's Encrypt. SSL certificates are renewed automatically 30 days before expiry.
Licensing
Community
Free
1 agent (node/server)
- Core infrastructure monitoring
- Docker & container visibility
- Basic alerting
- Community support
Professional
$49/mo
Up to 10 agents
- Everything in Community
- Vulnerability scanning
- Secrets management
- Email support (48h SLA)
Enterprise
Custom
Unlimited agents
- Everything in Professional
- SSO/SAML
- Audit logs & RBAC
- Dedicated support + SLA
Activating your license
- Sign up at infrapilot.org/signup to receive a license key via email.
- In the InfraPilot dashboard, go to Settings → License.
- Paste your license key and click Activate.
- The dashboard will confirm activation and unlock the features for your tier.
Agent Setup
The InfraPilot agent runs on each server you connect. It runs as a Docker container and talks to the dashboard over a secure gRPC connection (mutual TLS). Copy the exact command from Settings → Agents → Add Agent, which fills in your hub URL, enrollment token, and registry credentials.
Installing the agent (Docker)
# Run on the server you want to connect (Docker required)
curl -fsSL https://infrapilot.org/agent-install.sh | bash -s -- \
--hub https://infra.example.com \
--token YOUR_ENROLLMENT_TOKEN
For low-end / IoT / Docker-less nodes, an experimental native build is available at https://infrapilot.org/ip-agent-rust.sh.
Getting your agent token
In the dashboard, go to Settings → Agents → Add Agent. A unique token will be generated for each server you connect. Tokens are tied to your license and count toward your agent limit.
Agent tokens grant monitoring access to your server. Keep them secret and rotate immediately if compromised via Settings → Agents.
Security
Best practices
- Run InfraPilot behind a reverse proxy with HTTPS, never expose port 3000 directly
- Use a strong, unique NEXTAUTH_SECRET (32+ random characters)
- Enable two-factor authentication (Settings → Security → 2FA)
- Restrict dashboard access via your firewall to trusted IP ranges when possible
- Rotate agent tokens periodically and immediately if a server is decommissioned
- Keep InfraPilot updated, run `docker compose pull && docker compose up -d` regularly
Reporting vulnerabilities
Found a security issue? Please disclose responsibly by emailing security@infrapilot.org. We aim to acknowledge reports within 24 hours and resolve critical issues within 72 hours.
Troubleshooting
Dashboard won't start, 'database connection refused'
Ensure the database container is healthy before the app container starts. Run `docker compose ps` to check container status. If the db shows as unhealthy, check `docker compose logs db`.
License activation fails with 'key not found'
Check that you copied the full key without extra spaces. License keys are case-sensitive. If the issue persists, contact support@infrapilot.org with your account email.
Agent is offline / not appearing in dashboard
Verify the agent can reach your dashboard URL on port 443 (or 80). Check `systemctl status infrapilot-agent` and `journalctl -u infrapilot-agent -n 50` for error messages. Firewall rules between agent server and dashboard are the most common cause.
Nginx proxy not routing traffic correctly
Confirm the container target port matches what the service actually listens on. Use `docker compose logs nginx` to inspect routing errors. Check that SSL certificates are valid via Settings → Security.
High memory usage
InfraPilot retains recent log data in memory for fast search. Adjust the LOG_RETENTION_MB env variable (default: 256) in your .env to reduce memory pressure. Container will automatically prune older entries.
Forgot dashboard admin password
Use the CLI reset tool: `docker compose exec app infrapilot reset-password --email your@email.com`. A reset link will be sent to your registered email address.
Still need help?
Can't find what you're looking for? Open an issue on GitHub or reach out to our support team.