The Lightweight, Modern IPAM & HomeLab Dashboard. Built for simple and convenient network administration. NetWeave is based on Rust and React — extremely fast, fulfilling all the needs of a modern IPAM and HomeLab dashboard.
- Embedded Homepage: A public homepage to display your network overview, services status and important links.
- Dynamic IPAM: Comprehensive IP Address Management supproting static and dynamic leases.
- Device Management: Hardware tracking with MAC address mapping and IP identification.
- AdGuard Integration: Native sync with AdGuard Home for managing DHCP leases and static assignments.
- Service Monitoring: Real-time status and percentage uptime of your local services.
- Authentication: Username/password and OIDC SSO support with role-based access control.
- Settings: Configurable public homepage and application preferences.
- Security and Performance: Only 50MB RAM usage, OIDC, encryption, secure cookies, and more.
# Download the compose file and environment template
curl -O https://raw.githubusercontent.com/mi7chal/netweave/main/compose.yaml
curl -O https://raw.githubusercontent.com/mi7chal/netweave/main/.env.example
cp .env.example .env
# IN .env set ENCRYPTION_KEY and SESSION_SECRET at minimum
# Generate keys using `openssl rand -hex 32`
# Start NetWeave
docker compose up -dNetWeave will be available at http://localhost:8789.
For example Kubernetes deployment, see My Kubernetes Setup.
| Variable | Description | Default |
|---|---|---|
DATABASE_URL |
PostgreSQL connection string | required |
DEFAULT_ADMIN_USER |
Initial admin username | admin |
DEFAULT_ADMIN_PASSWORD |
Initial admin password | adminpassword |
ENCRYPTION_KEY |
64-char hex key for secret encryption | required |
SESSION_SECRET |
Session signing secret | auto-generated |
SESSION_SECURE_COOKIE |
Set to true when behind HTTPS |
false |
RUST_LOG |
Log level (debug, info, warn) |
info |
OIDC_CONFIGURATION_URL |
OIDC configuration URL | optional |
OIDC_CLIENT_ID |
OIDC client ID | optional |
OIDC_CLIENT_SECRET |
OIDC client secret | optional |
OIDC_REDIRECT_URL |
OIDC callback URL | optional |
See .env.example for a full reference.
cp .env.example .env
# Edit .env as needed (NETWEAVE_ENV=dev skips ENCRYPTION_KEY requirement)
# Start development dependencies (PostgreSQL + pgweb)
docker compose -f compose.dev.yaml up -d
# Run the backend (terminal 1)
cargo run
# Run the frontend (terminal 2)
cd web && pnpm install && pnpm dev- Backend:
http://localhost:8789 - Frontend dev server:
http://localhost:5173(proxies API to backend) - pgweb:
http://localhost:8081
See CONTRIBUTING.md for the full contributor guide.
For security info (and reporting vulnerabiltiies) see SECURITY.md.
NetWeave welcomes all contributions! See CONTRIBUTING.md for guidelines.
See CHANGELOG.md for release history.
This project utilized AI assistance during development. However, all code was manually reviewed, cleaned up, and tested by the author to ensure reliability and security.
© 2026 mi7chal. Distributed under the Apache License 2.0.