This page covers common configuration steps for OpenWISP deployments.
After first login with default credentials (admin/admin):
- Navigate to Users → Users in the admin panel
- Change the default admin password
- Create additional operator accounts with appropriate permissions
- Go to Users → Organizations
- Create your organization(s)
- Assign users to organizations for multi-tenancy
- Navigate to Config → Devices
- Click Add Device
- Configure:
- Name: Device hostname
- Organization: Associated organization
- Management IP: Device IP address
- Model: Device model for template matching
- Go to Config → Templates
- Create templates for common configurations:
- VLAN settings
- Wireless networks
- Firewall rules
- QoS policies
Group devices for bulk operations:
- By location
- By device type
- By function
OpenWISP uses NetJSON for device communication:
{
"type": "Device",
"hostname": "router1",
"ip_addresses": ["192.168.1.1"],
"config": {
"interfaces": []
}
}
Configure in Monitoring → Settings:
- Check intervals
- Alert thresholds
- Notification channels (email, webhooks)
- Configuration changes are pushed automatically to connected devices
- Firmware updates can be scheduled through the web interface
- Monitor the Tasks queue for deployment status
- Check device connectivity status in the dashboard
- Review configuration audit logs
- Verify monitoring metrics are being collected