Homarr на Ubuntu 24.04: пошаговая установка

MAATRIX

Когда на сервере живёт десяток сервисов — Portainer на одном порту, Nextcloud на другом, торрент-клиент на третьем, — держать в голове адреса и открывать пять вкладок неудобно. Homarr решает эту проблему одним экраном: дашборд-агрегатор, где все ваши приложения собраны в виде плиток с drag-and-drop настройкой, без правки конфигов руками. Ниже — пошаговая установка на чистом VPS с Ubuntu 24.04: от Docker до защищённого HTTPS-доступа к панели.

Шаг 1. Подготовка сервера

Нужен VPS на Ubuntu 24.04 с root-доступом. Сам Homarr — лёгкое веб-приложение, ресурсы съедают сервисы, которые вы будете на него выводить, поэтому для панели плюс небольшой набор контейнеров хватает 1–2 ядер и 2 ГБ RAM. Если Homarr будет единственной точкой входа для десятка сервисов на этом же сервере, закладывайте ресурсы уже под них, а не под саму панель.

Обновите систему перед началом:

apt update && apt upgrade -y

Локацию сервера выбирайте по тому, где физически находятся ваши пользователи и остальные сервисы, а не по самой панели — ей задержка почти не важна. У MAATRIX доступны RU, US и UK локации с оплатой из России картой, СБП или криптовалютой, так что панель можно ставить туда же, где уже стоят остальные ваши контейнеры.

Шаг 2. Установка Docker и Compose

Homarr распространяется как Docker-образ, поэтому сначала ставим Docker. Официальный скрипт сам подключает нужный репозиторий для Ubuntu 24.04 и добавляет плагин Compose:

curl -fsSL https://get.docker.com | sh
systemctl enable --now docker
docker compose version

Команда systemctl enable --now docker включает автозапуск демона — без неё после перезагрузки VPS ни Docker, ни панель сами не поднимутся, даже с правильной политикой restart у контейнера. Проверьте, что движок в порядке:

docker run --rm hello-world

Если вывод про успешный запуск тестового контейнера появился — можно переходить к самому Homarr.

Шаг 3. Развёртывание Homarr через docker compose

Заведите отдельную директорию под конфиг панели:

mkdir -p /opt/homarr && cd /opt/homarr

Homarr шифрует часть внутренних данных (токены интеграций, пароли к внешним сервисам), и для этого ему нужен собственный ключ шифрования — сгенерируйте его один раз и сохраните, при потере ключа сохранённые интеграции придётся вводить заново:

openssl rand -hex 32

Создайте compose.yaml, подставив сгенерированный ключ вместо ваш_ключ_из_openssl:

services:
  homarr:
    container_name: homarr
    image: ghcr.io/homarr-labs/homarr:latest
    restart: unless-stopped
    ports:
      - "127.0.0.1:7575:7575"
    environment:
      - SECRET_ENCRYPTION_KEY=ваш_ключ_из_openssl
    volumes:
      - homarr-appdata:/appdata
      - /var/run/docker.sock:/var/run/docker.sock:ro

volumes:
  homarr-appdata:

Том homarr-appdata хранит всю конфигурацию панели (доски, плитки, пользователей) — без него любое пересоздание контейнера обнулит настройки. Сокет docker.sock смонтирован в режиме только для чтения и нужен опционально: он даёт Homarr виджет со списком контейнеров хоста прямо на доске. Если такой виджет не нужен, эту строку можно не добавлять — панель прекрасно работает и без доступа к Docker-сокету, просто как каталог ссылок.

Порт снова привязан к 127.0.0.1 намеренно: наружу отдадим панель через reverse proxy на следующих шагах, а не голым HTTP. Запустите:

docker compose up -d
docker compose logs -f homarr

Дождитесь в логах сообщения о готовности сервера и остановите просмотр логов через Ctrl+C.

Шаг 4. Первый вход и мастер настройки

Так как порт закрыт снаружи, зайдите на панель через SSH-туннель с рабочей машины:

ssh -L 7575:127.0.0.1:7575 root@IP-сервера

Откройте в браузере http://localhost:7575. При первом заходе Homarr предложит создать учётную запись администратора — задайте логин и надёжный пароль, отдельный от паролей к серверу и другим сервисам. Дальше мастер попросит назвать первую доску (board) — можно оставить дефолтное имя, доски легко переименовать и добавить новые позже.

На этом этапе панель уже работает, но пустая. Наполнение — следующий шаг, и именно ради него Homarr обычно и ставят.

Шаг 5. Наполнение дашборда: плитки, виджеты, drag-and-drop

Главная идея Homarr — вы не редактируете JSON или YAML руками, а собираете доску мышью прямо в браузере. Нажмите на редактирование доски и добавьте первую плитку приложения: укажите название, URL сервиса (например, https://portainer.example.com) и иконку — Homarr подтягивает иконки популярных сервисов автоматически из встроенной библиотеки по названию.

Плитки можно перетаскивать по сетке, менять размер (от компактной ссылки до крупного блока со статусом) и группировать по категориям — например, «Инфраструктура», «Медиа», «Разработка». Помимо ссылок на приложения доступны виджеты:

• часы и погода — просто украшают доску;
• RSS-лента — новости из выбранных источников без отдельного ридера;
• список Docker-контейнеров хоста — состояние, CPU, память (нужен смонтированный docker.sock);
• интеграции с популярными сервисами через API-ключ (torrent-клиенты, медиасерверы, DNS-блокировщики) — статус и базовые метрики прямо на плитке.

Для интеграций конкретного сервиса Homarr обычно просит URL и API-токен этого сервиса — их нужно сгенерировать в самом интегрируемом приложении и вставить в настройках плитки. Это тот момент, где и пригождается сгенерированный на шаге 3 ключ шифрования: токены хранятся зашифрованными в томе homarr-appdata.

Если сервисов много, заведите несколько досок — рабочую и личную, или разделение по проектам — и переключайтесь между ними одним кликом, не пересобирая одну гигантскую сетку плиток.

Шаг 6. HTTPS-доступ и защита панели

Ходить через SSH-туннель постоянно неудобно, а открывать 7575 напрямую в интернет по HTTP — плохая идея: панель хранит ссылки и токены ко всей вашей инфраструктуре. Поставьте перед ней reverse proxy с TLS. Быстрый вариант — Nginx с certbot:

apt install nginx certbot python3-certbot-nginx -y

Конфиг /etc/nginx/sites-available/homarr.conf:

server {
    listen 80;
    server_name homarr.example.com;
    location / {
        proxy_pass http://127.0.0.1:7575;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

Включите сайт и выпустите сертификат — домен homarr.example.com должен заранее указывать A-записью на IP сервера:

ln -s /etc/nginx/sites-available/homarr.conf /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d homarr.example.com

Если у вас уже есть Traefik на сервере под другие контейнеры, логичнее подключить Homarr к нему через лейблы вместо отдельного Nginx — этот вариант подробно разобран в статье про установку Traefik на Ubuntu 24.04.

Дополнительно закройте прямой доступ к порту 7575 файрволом, оставив только 80/443 для внешнего мира — как это настроить на Ubuntu 24.04, описано в статье про настройку UFW. И держите пароль администратора Homarr отдельным и надёжным: с учётом смонтированного docker.sock и хранящихся API-токенов доступ к панели по сути равен доступу ко всей связке сервисов на сервере — тот же принцип, что и у Portainer, только здесь речь скорее о ссылках и токенах, чем о прямом управлении контейнерами.

Частые вопросы