Download Netwarden Agent
Monitor your infrastructure from the inside. Available for all major platforms and architectures.
Choose Your Platform
Download the agent for your operating system and architecture
All architectures supported
Linux
Quick Install
curl -fsSL https://get.netwarden.com/install.sh | sudo bash -s -- --tenant-id YOUR_TENANT_ID --api-key YOUR_API_KEYAutomated installation with configuration
AMD64 (x86_64)
ARM64 (AArch64)
Windows
AMD64 (x86_64)
Installation Methods
Choose the installation method that works best for your environment
Package Managers
Install via your system's package manager for automatic updates and easy management.
- Automatically installs as a system service
- Handles dependencies and updates
- Linux: systemd service files included
- macOS: Manual service setup (launchd guide included)
Direct Binary
Download and run the standalone binary for maximum control and minimal dependencies.
- No installation required
- Single executable file
- Run manually or via cron/scheduler
- Portable across systems
Docker Container
Run the agent in a containerized environment for isolation and orchestration.
- docker run netwarden/agent
- Mount config and volumes
- Perfect for Kubernetes deployments
- Isolated environment
Open Source
The Netwarden agent is open source. Contribute, review, or build from source.
Build from Source
git clone https://github.com/netwarden/agent.git && cd agent && make build-allRequires Go 1.21+ and make
Repository
View the source code, report issues, or contribute to the project on GitHub.
View on GitHubConfiguration
Get started quickly with our example configuration
Quick Configuration (After Installing Package)
Configure and start the agent with this one command:
TENANT_ID="your-tenant-id" API_KEY="your-api-key" && sudo sed -i "s/^tenant_id:.*/tenant_id: $TENANT_ID/; s/^api_key:.*/api_key: $API_KEY/" /etc/netwarden/netwarden.conf && sudo systemctl start netwardenReplace "your-tenant-id" and "your-api-key" with actual values from your Netwarden dashboard
# Netwarden Agent Configuration File # Copy this file to /etc/netwarden/netwarden.conf and update with your settings # ==================== # REQUIRED SETTINGS # ==================== # Your Netwarden Tenant ID (required) # Get this from your Netwarden dashboard settings tenant_id: YOUR_TENANT_ID_HERE # Your Netwarden API key (required) api_key: YOUR_API_KEY_HERE # Hostname (optional - auto-detected if not specified) # hostname: my-server # ==================== # COLLECTION SETTINGS # ==================== # Collection interval in seconds (default: 60) collection_interval: 60 # Batch size for metrics submission (default: 100) batch_size: 100 # ==================== # MONITORING OPTIONS # ==================== # Enable container metrics collection (default: true) enable_containers: true # Enable process metrics collection (default: true) enable_process_monitoring: true # ==================== # LOGGING # ==================== # Log level: debug, info, warn, error (default: info) log_level: info
Getting Your API Key
- 1Sign up at netwarden.com
- 2Navigate to Settings → API Keys
- 3Create a new agent token
- 4Copy the token to your config
Ready to start monitoring?
Download the agent, add your API key, and start collecting metrics in minutes.