HomeLabDocs/homarr_complete.md

🧩 Homarr - Container 112

Overview

Homarr is a sleek, customizable homepage dashboard that consolidates self-hosted services into one convenient UI. In this homelab, Homarr runs natively inside an unprivileged LXC container on Proxmox (not Docker), installed using the community script.

Service Details

• Container ID: 112
• Hostname: homarr
• IP Address: http://192.168.1.33:7575
• Port: 7575 (Web UI)
• Access: LAN-only (secured via Tailscale or VLAN isolation)
• Authentication: Disabled by default (access protected via local network)
• Admin Login: Stored in Bitwarden under homelab > Homarr (if enabled)

Hosting & Platform

• Proxmox Host Node: proxmox04
• OS Type: Debian 12
• LXC Type: Unprivileged
• CPU Cores: 3
• RAM: 6144 MiB
• Disk Size: 8 GB
• Bridge: vmbr0
• IPv4: 192.168.1.33/24
• Gateway: 192.168.1.1
• IPv6: SLAAC/Auto
• FUSE Support: Disabled
• Root SSH Access: Enabled
• Features: keyctl=1, nesting=1
• Tags: arr, dashboard, community-script
• Autostart: ✅ Enabled (onboot: 1)

Deployment & Service

• Installation Method: Community Script (via GitHub)
• Version: Homarr 1.28.1
• Node.js Version: 22
• Package Manager: pnpm@10.13.1
• Service Path: /opt/homarr/start.sh
• Runs As: root
• Service Manager: systemd (homarr.service)

systemd Service File

/etc/systemd/system/homarr.service

[Unit]
Description=Homarr Dashboard
After=network.target

[Service]
Type=simple
ExecStart=/opt/homarr/start.sh
WorkingDirectory=/opt/homarr
Restart=always
User=root
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

Storage & Mounts

Host Path	Container Path	Purpose
/mnt/smb_shares/dash_config	/var/lib/homarr	Persistent Homarr config
/mnt/smb_shares/common_icons	/var/lib/homarr/public/icons	Optional custom icon set

Configuration

• Config Path: /var/lib/homarr/configs/
• Environment Variables:
  • PORT=7575
  • NODE_ENV=production
• Reverse Proxy (optional): Cloudflare Tunnel or Apache/Nginx
• TLS: Not enabled directly on Homarr (handled via proxy if needed)

Backup & Recovery

• Backup Target: /var/lib/homarr
• Strategy: Scheduled LXC snapshots + tarball or rsync
• Manual Backup:

  tar -czvf /root/homarr-config-backup-$(date +%F).tar.gz /var/lib/homarr
  

Logs & Monitoring

• Log Path: No centralized log; recommend redirecting stdout to /var/log/homarr.log via systemd if needed
• Monitoring: Not yet configured (can integrate with Netdata, Uptime Kuma, or Homarr widgets)

Updates

Manual update steps:

systemctl stop homarr
cd /opt/homarr
git pull origin main
pnpm install --frozen-lockfile --production
systemctl start homarr

Notes

• Authentication is disabled — access is restricted at the network level.
• Config files are versioned JSON stored at /var/lib/homarr/configs/.
• IPv6 is enabled, but not internet-routable.
• Icons can be customized under public/icons/ for enhanced UI.
• Container created using the Proxmox community-script installer.