First-Run Checklist
A clean install gives you an empty admin panel. Here’s the path to your first active subscriber.
1. Change the admin password
Section titled “1. Change the admin password”The installer printed a random 24-char password. Log in, then:
- Click your username (top-right) → Profile
- Change Password → save
- (Recommended) Settings → Security → enable 2FA
2. Configure your first NAS
Section titled “2. Configure your first NAS”The NAS is the BNG router that does RADIUS auth on behalf of subscribers.
Settings → NAS → Add NAS
| Field | Example |
|---|---|
| Name | mikrotik-main |
| IP Address | 192.168.1.1 (router LAN IP that will send RADIUS packets) |
| Secret | strong random string (also configured on the router) |
| Backend kind | mikrotik (or generic for Cisco/Juniper) |
| API username/password | for live actions (Torch, Ping, queue sync) |
| API port | 8728 (or 8729 for TLS) |
After save, click Test Connection. You should see OK — 16 cores, 18d uptime, ROS 7.x.
On the MikroTik side:
/radius add service=ppp address=<ProxPanel-IP> secret=<same-secret> timeout=2s/radius incoming set accept=yes port=3799/ppp aaa set use-radius=yes accounting=yes interim-update=1m3. Create at least one service plan
Section titled “3. Create at least one service plan”Services → Add Service
Minimum required:
- Name (
4M-50GB) - Speed: 4000 kb download / 2000 kb upload (= 4 Mbps / 2 Mbps)
- Monthly quota: 50 GB
- Price: 25 USD
- Expiry: 30 days
You can add FUP tiers, CDN profiles, time-based discounts later — see Services.
4. Add IP pool
Section titled “4. Add IP pool”If you’re using dynamic IPs from MikroTik:
- The pool is configured on MikroTik (
/ip pool add name=4M-pool ranges=10.1.4.1-10.1.4.254) - In ProxPanel: edit the service → Pool Name =
4M-pool
For static IP per subscriber, see Static IP Assignment.
5. Create the first subscriber
Section titled “5. Create the first subscriber”Subscribers → Add Subscriber
- Username:
test@isp.com - Password:
something-strong - Full name + phone (optional)
- Service:
4M-50GB - Expiry: 30 days from today
6. Test PPPoE login
Section titled “6. Test PPPoE login”Have a customer / lab client dial PPPoE with those credentials. Within a few seconds you should see:
- Sessions page → user appears as online with assigned IP
- Subscribers page → online indicator turns green
- Dashboard → “Active Sessions” counter +1
If auth fails, check:
- RADIUS logs:
docker logs proxpanel-radius --tail 50 - Common issues are documented in PPPoE Auth Troubleshooting.
7. Optional next steps
Section titled “7. Optional next steps”- Replace self-signed cert with Let’s Encrypt —
certbot --nginx -d panel.yourdomain.com - Set up automated backups — Settings → Backups → schedule
- Connect SMTP for invoice + notification emails
- Enable Customer Portal so subscribers can self-serve
- Add resellers if you have partner ISPs
Done. You’re ready for paying customers.