proxmox/docs/04-configuration/UDM_PRO_ADD_BUTTON_MANUAL_GUIDE.md

UDM Pro Static Routes - Manual Add Button Guide

Last Updated: 2026-01-14
Status: Active Documentation Issue: Automation script needs manual Add button click

---

Quick Solution

The automation script successfully navigated to the Static Routes page but needs you to click the "Add" button manually. Here's how to find it:

---

Step-by-Step Instructions

Step 1: Access Static Routes Page

1. Open browser (if not already open)
2. Navigate to: https://192.168.0.1
3. Log in with credentials:
   • Username: unifi_api
   • Password: L@kers2010$$
4. Go to: Settings → Routing & Firewall → Static Routes
   • Or directly: https://192.168.0.1/network/default/settings/routing

Step 2: Find the Add Button

The Add button is typically located in one of these locations:

Location 1: Top Right of Routes Table

• Look for a "+" icon or "Add" button in the top-right corner of the routes table
• Usually next to the "Static Routes" heading

Location 2: Table Header

• Check the table header row
• Look for a button with a plus icon (+) or text "Add"

Location 3: Toolbar/Header

• Check the page header or toolbar area
• May be an icon-only button (just a "+" symbol)

Location 4: Empty State

• If no routes exist, there may be a large "Add Route" button in the center

Step 3: Click the Add Button

1. Click the Add button (or "+" icon)
2. Wait for the form to appear (should appear within 2-3 seconds)
3. The automation script will automatically:
   • Detect the form
   • Fill in the route details
   • Save the route

---

What the Form Should Look Like

After clicking Add, you should see a form with fields like:

• Name (or Route Name)
• Destination Network (or Destination)
• Gateway (or Gateway IP)
• Distance (optional)
• Interface (optional)

You don't need to fill anything - the script will do it automatically!

---

Troubleshooting

Can't Find the Add Button?

1. Check Screenshot:

   # View the latest screenshot
   ls -lt scripts/unifi/screenshots/*.png | head -1
   

   • Open the most recent screenshot to see what the page looks like

2. Try Different Views:

   • Look for tabs: "Static Routes", "Routes", "IPv4 Routes"
   • Check if there's a dropdown menu with "Add Route" option

3. Check Permissions:

   • Ensure you're logged in with an admin account
   • Verify the account has network management permissions

4. Refresh the Page:

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

Form Doesn't Appear After Clicking Add?

1. Check Browser Console:

   • Press F12 to open DevTools
   • Look for JavaScript errors in the Console tab
   • Report any errors

2. Try Alternative Methods:

   • Right-click the Add button → Inspect Element
   • Check if the button is actually clickable
   • Verify no overlays are blocking the button

3. Manual Form Filling (If Script Fails): If the script doesn't detect the form, you can fill it manually:

   • Name: Route to VLAN 11
   • Destination: 192.168.11.0/24
   • Gateway: 192.168.11.1
   • Distance: 1 (or leave default)
   • Click Save or Add

---

Alternative: Run Script Again

If you want to try again with the automation script:

cd /home/intlc/projects/proxmox
UNIFI_USERNAME=unifi_api UNIFI_PASSWORD='L@kers2010$$' \
  HEADLESS=false PAUSE_MODE=true \
  node scripts/unifi/configure-static-route-playwright.js

This time:

1. Watch the browser window carefully
2. When it reaches the Static Routes page, immediately look for the Add button
3. Click it as soon as you see it
4. The script will detect the form and continue automatically

---

Visual Reference

The Add button typically looks like one of these:

• Icon-only: A "+" symbol in a circle or square button
• Text button: "Add", "Add Route", "Create Route", or "+ Add"
• Location: Usually in the top-right area of the routes table or page header

---

After Success

Once the route is created, verify it:

1. Check the routes list:

   • Look for "Route to VLAN 11" in the list
   • Verify destination: 192.168.11.0/24
   • Verify gateway: 192.168.11.1

2. Test connectivity:

   # From Default network (192.168.0.x)
   ping 192.168.11.1   # Should succeed
   ping 192.168.11.10  # Should succeed
   

---

Last Updated: 2026-01-14