# 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