d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
main
proxmox/docs/04-configuration/UDM_PRO_SYSTEM_SETTINGS_GUIDE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Details
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates 
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

7.1 KiB
Raw Permalink Blame History

UDM Pro System Settings Configuration Guide

Last Updated: 2025-01-20
Status: Manual Configuration Guide

Overview

This guide provides instructions for configuring system settings on the UDM Pro, including hostname, timezone, NTP, and other system-level configurations.

Accessing System Settings

  1. Access UniFi Network Web Interface:

    • Open browser: https://192.168.0.1
    • Log in with admin credentials

  2. Navigate to System Settings:

    • Go to Settings → System Settings
    • Or: Settings → Site → System Settings

Hostname Configuration

Setting Hostname

  1. Access Hostname Settings:

    • Navigate to Settings → System Settings → General
    • Or: Settings → Site → Site Name

  2. Configure Hostname:

    • Site Name/Hostname: Enter appropriate hostname
      • Example: udm-pro-primary or udm-pro-01
      • Use descriptive name that identifies the device
    • Site Description (optional): Add description if needed

  3. Save Changes:

    • Click Apply Changes or Save
    • Changes may require device restart in some cases

Timezone Configuration

Setting Timezone

  1. Access Timezone Settings:

    • Navigate to Settings → System Settings → General
    • Or: Settings → Site → Timezone

  2. Select Timezone:

    • Timezone: Select appropriate timezone
      • Example: America/Los_Angeles (Pacific Time)
      • Example: America/New_York (Eastern Time)
      • Example: UTC (Coordinated Universal Time)

  3. Save Changes:

    • Click Apply Changes
    • Timezone is applied immediately

NTP (Network Time Protocol) Configuration

Configuring NTP Servers

  1. Access NTP Settings:

    • Navigate to Settings → System Settings → General
    • Or: Settings → Site → Time Settings

  2. Configure NTP Servers:

    • NTP Server 1: pool.ntp.org or 0.pool.ntp.org
    • NTP Server 2: 1.pool.ntp.org or time.google.com
    • NTP Server 3 (optional): 2.pool.ntp.org or time.cloudflare.com

    Recommended NTP Servers:

    • pool.ntp.org (NTP Pool Project)
    • time.google.com (Google Public NTP)
    • time.cloudflare.com (Cloudflare NTP)
    • 0.us.pool.ntp.org (Regional NTP pool)

  3. Verify Time Synchronization:

    • Check system time is correct
    • Verify logs show correct timestamps
    • Monitor NTP synchronization status

System Information

Viewing System Information

  1. Access System Info:

    • Navigate to Settings → System Settings → General
    • Or: Dashboard → System Information

  2. System Details:

    • Model: UDM Pro
    • Firmware Version: Check current version
    • Uptime: System uptime
    • System Resources: CPU, Memory, Storage

Backup Configuration

Enabling Automatic Backups

  1. Access Backup Settings:

    • Navigate to Settings → System Settings → Backups
    • Or: Settings → Maintenance → Backups

  2. Configure Automatic Backups:

    • Enable Automatic Backups: Enable checkbox
    • Backup Frequency: Daily, Weekly, or Monthly
    • Backup Retention: Number of backups to keep
    • Backup Location: Local storage or cloud (if configured)

  3. Manual Backup:

    • Click Download Backup or Export Configuration
    • Save backup file securely
    • Recommended: Regular manual backups before major changes

SSL Certificate Configuration

Current Status

  • Development: Using self-signed certificate
  • Production: Install proper SSL certificate (recommended)

Installing SSL Certificate (Production)

  1. Access SSL Settings:

    • Navigate to Settings → System Settings → Certificate
    • Or: Settings → Site → Certificate

  2. Install Certificate:

    • Option 1: Let's Encrypt (Recommended)

      • Enable Let's Encrypt certificate
      • Enter domain name
      • Configure email for notifications
      • Certificate auto-renews

    • Option 2: Upload Certificate

      • Upload certificate file (PEM format)
      • Upload private key file
      • Upload certificate chain (if applicable)

  3. Verify Certificate:

    • Check certificate expiration date
    • Verify certificate is valid
    • Test HTTPS access

Maintenance Settings

Auto-Updates

  1. Access Update Settings:

    • Navigate to Settings → System Settings → Updates
    • Or: Settings → Maintenance → Updates

  2. Configure Updates:

    • Auto-Update: Enable/disable automatic updates
    • Update Schedule: Configure update window
    • Update Channel: Stable, Beta, or Release Candidate

System Logs

  1. Access Logs:

    • Navigate to Settings → Logs or Insights → Logs
    • View system logs, event logs, firewall logs

  2. Log Retention:

    • Configure log retention period
    • Set log level (Debug, Info, Warning, Error)

Verification

After configuring system settings:

  1. Verify Hostname:

    • Check hostname appears correctly in UI
    • Verify hostname in system information

  2. Verify Timezone:

    • Check system time matches timezone
    • Verify logs show correct timestamps

  3. Verify NTP:

    • Check NTP synchronization status
    • Verify system time is accurate
    • Monitor NTP server connectivity

  4. Verify Backups:

    • Check backup schedule is active
    • Verify backups are being created
    • Test backup restoration (if possible)

Recommended Settings

Production Environment

  • Hostname: Descriptive, identifies location/role
  • Timezone: Match local timezone
  • NTP Servers: Use reliable public NTP servers (pool.ntp.org, time.google.com)
  • Auto-Updates: Enable for security patches (consider update window)
  • Backups: Enable automatic daily backups, retain 7-30 days
  • SSL Certificate: Use Let's Encrypt or proper certificate
  • Log Level: Info or Warning (Debug only for troubleshooting)

Development Environment

  • Hostname: Can use simple name (e.g., udm-pro)
  • Timezone: UTC or local timezone
  • NTP Servers: Default or public NTP servers
  • Auto-Updates: Optional (manual updates acceptable)
  • Backups: Weekly or manual backups sufficient
  • SSL Certificate: Self-signed acceptable
  • Log Level: Info or Debug (for troubleshooting)

Troubleshooting

Time Synchronization Issues

  • Verify NTP servers are reachable
  • Check firewall rules allow NTP traffic (UDP port 123)
  • Verify timezone is correct
  • Check system time manually if needed

Backup Issues

  • Verify storage space available
  • Check backup location is accessible
  • Verify backup schedule is enabled
  • Check backup logs for errors

Certificate Issues

  • Verify certificate format is correct (PEM)
  • Check certificate expiration date
  • Verify private key matches certificate
  • Test certificate chain is complete

Related Documentation

Last Updated: 2025-01-20

Reference in New Issue View Git Blame Copy Permalink