Quick Start Guide

Try the Demo

Before installing OpenWISP, we recommend trying out the OpenWISP Demo system. This will give you a great overview of how the system works.

Once you have explored the demo, you can install your own instance by following the instructions below.

Install OpenWISP

For production usage, we recommend Deploying OpenWISP with the Ansible OpenWISP role.

Alternatively, you can use Docker OpenWISP.

Make Sure OpenWISP Can Reach Your Devices

For smooth operations, please Setup a Management Network.

Configure Your OpenWrt Devices

Follow the guide to Configure Your OpenWrt Devices.

If you don't have a physical OpenWrt-compatible device, you can install OpenWrt in a VirtualBox VM. The guide above covers how to do this.

Learn More

Once you have everything set up, we recommend exploring other sections of this documentation to make the most out of OpenWISP.

Depending on your use case, you might be interested in different features:

  • Automating Configuration Provisioning: If your primary interest is automating the provisioning of configurations for OpenWrt devices, check out the Controller module.

  • Device Monitoring: For those who need monitoring information from their devices, the Monitoring module will be particularly useful.

  • WiFi Connectivity and Security: If you're focused on providing WiFi Hotspot connectivity or WPA Enterprise WiFi, take a look at the RADIUS and WiFi Login Pages modules.

Additionally, we offer tutorials for the most common scenarios:

Explore these resources to fully leverage the capabilities of OpenWISP!

Seek Help

Reach out to the Community Support Channels.