Add a new NAS, entering its IP address and a (a password shared strictly between the router and RADIUSdesk). 3. Creating Vouchers or Permanent Users
By default, the OVA may serve HTTP. Generate a Let's Encrypt SSL certificate or a self-signed certificate to encrypt administrator logins and captive portal traffic.
| Symptom | Likely Cause | Solution | | --- | --- | --- | | The virtual machine starts but the network does not come up. | udev has reassigned interface names due to changed MAC addresses. | Inside the VM, delete /etc/udev/rules.d/70-persistent-net.rules and reboot. | | VirtualBox shows a PAE kernel error. | PAE/NX is disabled in the VM settings. | Go to and enable Enable PAE/NX . | | The web interface does not load or returns HTTP 500 errors. | PHP permissions or database connection issues. | Check the web server error logs ( /var/log/nginx/error.log ). Verify that MySQL is running and that the credentials in config.php are correct. | | Authentication from MikroTik fails. | Shared secret mismatch or PAP not enabled. | Confirm that the RADIUS client entry in RADIUSdesk uses the same secret as the MikroTik router. Ensure the hotspot profile on MikroTik includes PAP. | | The Setup Wizard displays an error after creating a cloud. | Missing or incorrect server‑wide settings. | Close the wizard, go to Other → Settings , and verify the database hostname, port, and credentials. Then restart the wizard. | | A user cannot log in but RADIUS logs show nothing. | The NAS (AP/router) is not sending RADIUS requests to the correct IP. | Ensure the RADIUS server address in the NAS configuration points to the eth0 IP of the appliance. Check that no firewall on the NAS or the hypervisor blocks UDP ports 1812 and 1813. |
Add a new NAS, entering its IP address and a (a password shared strictly between the router and RADIUSdesk). 3. Creating Vouchers or Permanent Users
By default, the OVA may serve HTTP. Generate a Let's Encrypt SSL certificate or a self-signed certificate to encrypt administrator logins and captive portal traffic.
| Symptom | Likely Cause | Solution | | --- | --- | --- | | The virtual machine starts but the network does not come up. | udev has reassigned interface names due to changed MAC addresses. | Inside the VM, delete /etc/udev/rules.d/70-persistent-net.rules and reboot. | | VirtualBox shows a PAE kernel error. | PAE/NX is disabled in the VM settings. | Go to and enable Enable PAE/NX . | | The web interface does not load or returns HTTP 500 errors. | PHP permissions or database connection issues. | Check the web server error logs ( /var/log/nginx/error.log ). Verify that MySQL is running and that the credentials in config.php are correct. | | Authentication from MikroTik fails. | Shared secret mismatch or PAP not enabled. | Confirm that the RADIUS client entry in RADIUSdesk uses the same secret as the MikroTik router. Ensure the hotspot profile on MikroTik includes PAP. | | The Setup Wizard displays an error after creating a cloud. | Missing or incorrect server‑wide settings. | Close the wizard, go to Other → Settings , and verify the database hostname, port, and credentials. Then restart the wizard. | | A user cannot log in but RADIUS logs show nothing. | The NAS (AP/router) is not sending RADIUS requests to the correct IP. | Ensure the RADIUS server address in the NAS configuration points to the eth0 IP of the appliance. Check that no firewall on the NAS or the hypervisor blocks UDP ports 1812 and 1813. |
