fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- 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>
267 lines
7.1 KiB
Markdown
267 lines
7.1 KiB
Markdown
# 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
|
|
|
|
- [UDM_PRO_STATUS.md](./UDM_PRO_STATUS.md) - Configuration status
|
|
- [UDM_PRO_CONFIGURATION_CHECKLIST.md](./UDM_PRO_CONFIGURATION_CHECKLIST.md) - Complete checklist
|
|
|
|
---
|
|
|
|
**Last Updated:** 2025-01-20
|