proxmox/docs/04-configuration/UDM_PRO_MANUAL_ROUTE_CREATION.md

UDM Pro - Manual Static Route Creation

Last Updated: 2026-01-14
Status: Active Documentation Issue: Add button not visible, automation unable to find it

---

Quick Steps

1. Open Browser: https://192.168.0.1
2. Login: unifi_api / L@kers2010$$
3. Navigate: Settings → Routing & Firewall → Static Routes
4. Find Add Button (see locations below)
5. Fill Form:
   • Name: Route to VLAN 11
   • Destination: 192.168.11.0/24
   • Gateway: 192.168.11.1
   • Distance: 1
6. Click Save
7. Test: ping 192.168.11.10

---

Finding the Add Button

Location 1: Empty State

If no routes exist, you might see:

• Large button: "Create Route" or "Add Route"
• Text: "Create your first route" (click it)
• Empty state message in center of page

Location 2: Tabs

Look for tabs at the top:

• "Static Routes"
• "IPv4 Routes"
• "Routes"
• Click different tabs to see if Add button appears

Location 3: Top-Right Corner

• Look for "+" icon button
• "Add" text button
• Usually in toolbar/header area

Location 4: Table Header

• If routes table exists, check header row
• Look for "+" icon in header
• "Add" button in table toolbar

Location 5: Scroll Down

• Button might be below visible area
• Scroll the page down
• Check bottom of routes section

Location 6: Browser DevTools

1. Press F12 to open DevTools
2. Go to Console tab
3. Type and press Enter:

   document.querySelectorAll('button, a').forEach((btn, i) => {
     const text = btn.textContent.trim();
     if (text.toLowerCase().includes('add') || 
         text.toLowerCase().includes('create') ||
         text.toLowerCase().includes('route')) {
       console.log(i, text, btn.className, btn.id);
       btn.style.border = '3px solid red'; // Highlight it
     }
   });
   

4. This will highlight any buttons with "add", "create", or "route" in the text

---

Alternative: Direct URL (If Available)

Try navigating directly to the Add Route form:

• https://192.168.0.1/network/default/settings/routing/add
• https://192.168.0.1/network/default/settings/routing/new
• https://192.168.0.1/network/default/settings/routing/create

---

Troubleshooting

Still Can't Find Add Button?

1. Check Permissions:

   • Ensure unifi_api account has network management permissions
   • Verify account is admin-level

2. Try Different Browser:

   • Chrome, Firefox, Edge
   • Clear cache and cookies

3. Check Page Source:

   • Right-click page → View Page Source
   • Search for "add" or "route"
   • Look for button elements

4. Refresh Page:

   • Press F5 to refresh
   • Wait for page to fully load
   • Try again

5. Check for JavaScript Errors:

   • Press F12 → Console tab
   • Look for red error messages
   • Report any errors

---

Route Configuration Details

Route Name: Route to VLAN 11
Destination Network: 192.168.11.0/24
Gateway: 192.168.11.1
Distance: 1
Interface: (leave default or select VLAN 11 interface)

---

Verification

After creating the route:

1. Check Route List:

   • Should see "Route to VLAN 11" in the list
   • Verify destination and gateway are correct

2. Test Connectivity:

   ping -c 3 192.168.11.1   # Gateway
   ping -c 3 192.168.11.10 # Proxmox host
   

3. Check Routing Table (via API):

   cd /home/intlc/projects/proxmox
   NODE_TLS_REJECT_UNAUTHORIZED=0 node -e "
   const https = require('https');
   const fs = require('fs');
   const env = fs.readFileSync(require('os').homedir() + '/.env', 'utf8')
     .split('\n').filter(l => l.includes('='))
     .reduce((acc, l) => { 
       const [k, ...v] = l.split('='); 
       acc[k.trim()] = v.join('=').trim().replace(/^['\"]|['\"]$/g, ''); 
       return acc; 
     }, {});
   const options = {
     hostname: '192.168.0.1',
     path: '/proxy/network/api/s/default/rest/routing',
     method: 'GET',
     headers: { 'Authorization': 'Bearer ' + (env.UNIFI_API_KEY || '') },
     rejectUnauthorized: false
   };
   https.request(options, (res) => {
     let data = '';
     res.on('data', d => data += d);
     res.on('end', () => {
       try {
         const routes = JSON.parse(data).data || [];
         console.log('Routes:', routes.length);
         routes.forEach(r => console.log(r.name, r.network, r.gateway));
       } catch(e) { console.log('Error:', e.message); }
     });
   }).on('error', e => console.error(e.message)).end();
   " 2>&1 | grep -v Warning
   

---

Last Updated: 2026-01-14