elkurbo/airview-runner repository overview

⁠airview-runner

Run Ubiquiti AirMax AirView spectrum analyzer in your browser

⁠Quick Start

docker run -p 8080:8080 elkurbo/airview-runner -url http://192.168.1.20

Then open your browser to: http://localhost:8080⁠

The VNC session connects automatically - just point it at your Ubiquiti device and start analyzing!

⁠What is this?

This container runs Ubiquiti's AirView spectrum analyzer (JNLP application) with a web-based noVNC interface. No Java installation or VNC client needed - everything runs in your browser.

Features:

• 🌐 Browser-based access via noVNC
• 🚀 One command to run
• 📱 Access from any device with a browser

⁠Usage

⁠Basic Usage

docker run -p 8080:8080 elkurbo/airview-runner -url http://YOUR_DEVICE_IP

Example:

docker run -p 8080:8080 elkurbo/airview-runner -url http://192.168.1.20

Then navigate to: http://localhost:8080

⁠Run in Background

docker run -d -p 8080:8080 --name airview elkurbo/airview-runner -url http://192.168.1.20

View logs:

docker logs airview

Stop:

docker stop airview
docker rm airview

⁠Access from Another Device

Run on your server:

docker run -p 8080:8080 elkurbo/airview-runner -url http://192.168.1.20

Access from another computer on your network:

http://your-server-ip:8080

⁠Custom Port

docker run -p 9000:8080 elkurbo/airview-runner -url http://192.168.1.20

Access at: http://localhost:9000

⁠Requirements

• Docker installed
• Network access to your Ubiquiti device
• AirView feature enabled on your Ubiquiti device

⁠⚠️ IMPORTANT

Before running the Docker container, you must first initiate AirView from your device's WebUI:

1. Open your Ubiquiti device's web interface (e.g., http://192.168.1.20)
2. Navigate to Tools → AirView (or click the AirView button)
3. When prompted to download/open the JNLP file, click Cancel
4. Now you can run the Docker container - it will connect to the already-started AirView session

This is required because the device needs to start the AirView service before the Docker container can connect to it.

⁠Supported Devices

Any Ubiquiti AirMax M5 or M2 device with AirView capability:

• NanoStation
• LiteBeam
• PowerBeam
• And other AirMax devices with spectrum analyzer support

⁠How It Works

1. Container starts Xvfb (virtual display)
2. Launches x11vnc and noVNC (web VNC server)
3. Downloads and runs AirView JNLP from your device
4. You access it via browser

⁠Frequency Range Configuration

Frequency ranges must be configured in the AirView GUI after launch:

1. Open AirView in your browser
2. Go to Tools → Settings
3. Set your desired frequency range
4. Click Apply

Common ranges:

• 2.4 GHz: 2412-2462 MHz (US/Canada Ch 1-11)
• 5 GHz: 5180-5825 MHz (UNII-1 and UNII-3)

⁠Troubleshooting

Connection refused?

• Verify the Ubiquiti device IP is correct
• Ensure the device is reachable from the container
• Check that AirView is enabled on the device

Blank screen?

• Wait 10-15 seconds for AirView to load
• Check Docker logs: docker logs <container-name>

Port already in use?

• Use a different port: -p 8081:8080

Container won't stop?

• Use: docker stop <container-name>

⁠Technical Stack

• Ubuntu 22.04
• Java 11 + IcedTea Web Start
• Xvfb (virtual X11 display)
• x11vnc (VNC server)
• noVNC (web VNC client)
• Websockify
• Supervisor (process manager)
• Tini (init system)

⁠License

MIT License - feel free to use and modify!

⁠Support

• Report issues on GitHub
• Star the repo if you find it useful!
• Pull requests welcome

Made with ❤️ for the Ubiquiti community