Встановлення Mealie

Конфігурація

Після успішного запуску Mealie за допомогою Docker Compose, наступним кроком буде налаштування безпечного доступу через HTTPS з використанням вашого доменного імені. Ми будемо використовувати Caddy — сучасний веб-сервер, який автоматично отримує та оновлює SSL/TLS-сертифікати від Let's Encrypt.

1. Налаштування DNS

Перш ніж налаштовувати Caddy, переконайтеся, що ваш домен або піддомен (наприклад, recipes.yourdomain.com) вказує на IP-адресу вашого VPS. Для цього створіть або змініть A-запис у налаштуваннях DNS вашого доменного реєстратора:

Зачекайте деякий час, доки зміни DNS набудуть чинності (це може зайняти від кількох хвилин до кількох годин).

2. Встановлення Caddy

Ми запустимо Caddy як окремий Docker-контейнер, щоб він міг служити зворотним проксі для Mealie.

Створіть директорію для конфігурації Caddy:

mkdir -p ~/caddy/data ~/caddy/config # Створюємо директорії для даних та конфігурації Caddy
    

Створіть файл Caddyfile у директорії ~/caddy:

nano ~/caddy/Caddyfile # Відкриваємо файл Caddyfile для редагування
    

Вставте наступну конфігурацію, замінивши recipes.yourdomain.com на ваш домен:

recipes.yourdomain.com {
    # Вмикаємо стиснення gzip для прискорення завантаження
    encode gzip

    # Встановлюємо заголовки безпеки
    header {
        Strict-Transport-Security max-age=31536000;
        X-Frame-Options DENY
        X-Content-Type-Options nosniff
        X-XSS-Protection "1; mode=block"
        Referrer-Policy strict-origin-when-cross-origin
    }

    # Проксіюємо всі запити до Mealie Docker-контейнера
    reverse_proxy mealie:9000 {
        # Додаємо заголовки для правильної роботи WebSocket та HTTP/2
        header_up Host {host}
        header_up X-Real-IP {remote_ip}
        header_up X-Forwarded-For {remote_ip}
        header_up X-Forwarded-Proto {scheme}
    }

    # Вмикаємо логування (опціонально)
    log {
        output file /var/log/caddy/access.log
    }
}
    

Збережіть файл (Ctrl+O, Enter) та вийдіть (Ctrl+X).

3. Додавання Caddy до Docker Compose

Тепер відредагуємо файл docker-compose.yml, щоб додати сервіс Caddy. Відкрийте його:

nano ~/mealie/docker-compose.yml # Відкриваємо docker-compose.yml
    

Додайте наступний блок caddy в кінець файлу, на тому ж рівні відступу, що й mealie:

  caddy:
    image: caddy:2.7.6-alpine # Актуальна версія Caddy на 2026 рік
    restart: unless-stopped
    ports:
      - "80:80" # HTTP для Let's Encrypt
      - "443:443" # HTTPS
    volumes:
      - ~/caddy/Caddyfile:/etc/caddy/Caddyfile # Монтуємо наш Caddyfile
      - ~/caddy/data:/data # Для сертифікатів Let's Encrypt
      - ~/caddy/config:/config # Для конфігурації Caddy
      - ~/caddy/logs:/var/log/caddy # Для логів Caddy
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
    networks:
      - default # Підключаємо до тієї ж мережі, що й Mealie
    depends_on:
      - mealie # Caddy повинен запускатися після Mealie
    

Переконайтеся, що mealie та caddy знаходяться в одній Docker-мережі (за замовчуванням це мережа, створена Docker Compose, названа за іменем директорії, наприклад, mealie_default). У цьому випадку, networks: - default достатньо.

Збережіть зміни у docker-compose.yml.

4. Запуск Caddy та оновлення Mealie

Перезапустіть Docker Compose, щоб Caddy запустився і Mealie перепідключився до нової конфігурації:

cd ~/mealie # Переконайтеся, що ви знаходитесь в директорії з docker-compose.yml
docker compose down # Зупиняємо всі поточні контейнери
docker compose up -d # Запускаємо всі контейнери (Mealie та Caddy)
    

Caddy автоматично запитає та встановить SSL/TLS-сертифікат для вашого домену. Це може зайняти кілька секунд.

5. Перевірка працездатності

Відкрийте ваш домен (наприклад, https://recipes.yourdomain.com) у веб-браузері. Ви повинні побачити сторінку входу Mealie з активним HTTPS-з'єднанням.

Ви також можете перевірити доступність за допомогою curl:

curl -v https://recipes.yourdomain.com # Перевіряємо доступність та сертифікат
    

У виводі ви повинні побачити інформацію про сертифікат Let's Encrypt та код відповіді HTTP 200 OK.

Перший вхід до Mealie: Під час першого входу Mealie запропонує створити обліковий запис адміністратора. Заповніть форму, і ви отримаєте доступ до панелі керування.

Резервні копії та обслуговування

Регулярне резервне копіювання та своєчасне обслуговування є критично важливими для будь-якої self-hosted служби. Це гарантує збереження ваших даних та стабільну роботу Mealie.

1. Що резервувати

Для Mealie основними компонентами, які необхідно резервувати, є:

• База даних: Якщо ви використовуєте SQLite (за замовчуванням), це файл mealie.db. Якщо PostgreSQL, то це дамп бази даних. Цей файл або дамп містить усі ваші рецепти, категорії, користувачів та іншу структуровану інформацію.
• Медіафайли: Завантажені зображення, такі як фотографії страв, зберігаються в окремій директорії. Переконайтеся, що ви резервуєте цю директорію цілком.
• Конфігураційні файли: Файл .env та docker-compose.yml. Вони містять важливі налаштування та секрети, необхідні для відновлення сервісу.
• Конфігурація Caddy: Файл Caddyfile та директорії data/config (для сертифікатів Let's Encrypt).

2. Простий скрипт авторезервування

Ми створимо простий скрипт, який виконуватиме резервне копіювання бази даних SQLite та медіафайлів, а також конфігураційних файлів. Потім ми налаштуємо його запуск через cron.

Створіть директорію для резервних копій на VPS:

mkdir -p ~/backups/mealie # Створюємо директорію для резервних копій Mealie
    

Створіть файл скрипта backup_mealie.sh:

nano ~/backup_mealie.sh # Створюємо скрипт резервного копіювання
    

Вставте наступний вміст:

#!/bin/bash

# Пути к директориям
MEALIE_DIR="/home/$USER/mealie"
CADDY_DIR="/home/$USER/caddy"
BACKUP_DIR="/home/$USER/backups/mealie"
TIMESTAMP=$(date +%Y%m%d%H%M%S)
BACKUP_FILE="$BACKUP_DIR/mealie_backup_$TIMESTAMP.tar.gz"

echo "Запуск резервного копіювання Mealie о $TIMESTAMP..."

# 1. Зупиняємо Mealie для забезпечення цілісності БД (якщо використовується SQLite)
# Для Mealie 2.x зі SQLite, зазвичай можна обійтися без зупинки, але для гарантії можна зупинити.
# Якщо ви використовуєте PostgreSQL, краще зробити дамп через pg_dump, не зупиняючи Mealie.
# docker compose -f $MEALIE_DIR/docker-compose.yml stop mealie # Опціонально: зупиняємо сервіс mealie

# 2. Копіюємо файл бази даних SQLite
# Шлях до файлу mealie.db всередині контейнера, якщо він не винесений в окремий том
# Якщо mealie.db знаходиться в томі, який монтується, то він буде доступний на хості.
# У нашому docker-compose.yml Mealie 2.x використовує Named Volume 'mealie_data'.
# Щоб отримати шлях до файлу на хості, потрібно знайти шлях до цього тому.
# Найпростіше зробити дамп з контейнера або скопіювати файл, якщо том доступний.

# Получаем путь к тому mealie_data на хосте
MEALIE_VOLUME_PATH=$(docker volume inspect mealie_mealie_data --format '{{ .Mountpoint }}')

if [ -z "$MEALIE_VOLUME_PATH" ]; then
    echo "Error: Could not find mealie_data volume mountpoint. Exiting."
    exit 1
fi

echo "Резервне копіювання даних Mealie з $MEALIE_VOLUME_PATH..."

# Створюємо тимчасову директорію для збору файлів
TEMP_BACKUP_DIR=$(mktemp -d)

# Копіюємо базу даних (якщо SQLite)
cp "$MEALIE_VOLUME_PATH/mealie.db" "$TEMP_BACKUP_DIR/mealie.db"
echo "Скопійовано mealie.db"

# Копіюємо медіафайли
cp -R "$MEALIE_VOLUME_PATH/media" "$TEMP_BACKUP_DIR/media"
echo "Скопійовано медіафайли"

# Копіюємо конфігураційні файли Mealie
cp "$MEALIE_DIR/.env" "$TEMP_BACKUP_DIR/mealie_env"
cp "$MEALIE_DIR/docker-compose.yml" "$TEMP_BACKUP_DIR/mealie_docker-compose.yml"
echo "Скопійовано конфігураційні файли Mealie"

# Копіюємо конфігураційні файли Caddy
cp "$CADDY_DIR/Caddyfile" "$TEMP_BACKUP_DIR/caddy_Caddyfile"
# Дані та конфігурації Caddy (сертифікати)
cp -R "$CADDY_DIR/data" "$TEMP_BACKUP_DIR/caddy_data"
cp -R "$CADDY_DIR/config" "$TEMP_BACKUP_DIR/caddy_config"
echo "Скопійовано конфігурацію та дані Caddy"

# 3. Архівуємо все в один файл
tar -czf "$BACKUP_FILE" -C "$TEMP_BACKUP_DIR" . # Архівуємо вміст тимчасової директорії
echo "Створено архів резервної копії: $BACKUP_FILE"

# 4. Видаляємо тимчасову директорію
rm -rf "$TEMP_BACKUP_DIR"
echo "Тимчасову директорію очищено."

# 5. Запускаємо Mealie знову (якщо зупиняли)
# docker compose -f $MEALIE_DIR/docker-compose.yml start mealie # Опціонально: запускаємо сервіс mealie

# 6. Видаляємо старі резервні копії (наприклад, старші 7 днів)
find "$BACKUP_DIR" -type f -name 'mealie_backup_.tar.gz' -mtime +7 -delete # Видаляємо резервні копії старші 7 днів
echo "Старі резервні копії видалено."

echo "Резервне копіювання Mealie завершено."
    

chmod +x ~/backup_mealie.sh # Робимо скрипт виконуваним
    

# Копіювання резервної копії на віддалений сервер
REMOTE_USER="backupuser"
REMOTE_HOST="your_backup_vps_ip"
REMOTE_PATH="/path/to/remote/mealie_backups"

rsync -avz "$BACKUP_FILE" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_PATH" # Копіюємо архів на віддалений сервер
echo "Резервну копію скопійовано на віддалений сервер."
    

crontab -e # Відкриваємо crontab для поточного користувача
    

0 3    /home/$USER/backup_mealie.sh > /dev/null 2>&1 # Запускати скрипт резервного копіювання щодня о 03:00
    

Збережіть та вийдіть. Тепер резервні копії створюватимуться автоматично.

5. Оновлення: rolling vs maintenance window

• Оновлення Mealie: Оскільки Mealie розгорнуто через Docker Compose, оновлення дуже прості. Вам потрібно лише отримати нові образи та перезапустити контейнери.

  
  cd ~/mealie
  docker compose pull # Завантажуємо нові версії образів
  docker compose up -d # Перестворюємо контейнери з новими образами
              

  Рекомендується виконувати ці оновлення у "maintenance window" (вікно обслуговування), коли активність користувачів мінімальна, оскільки сервіс буде короткочасно недоступний. Перевіряйте офіційний репозиторій Mealie на предмет критичних змін або процедур міграції перед оновленням.
• Оновлення системи: Регулярно оновлюйте операційну систему та встановлені пакети:

  
  sudo apt update && sudo apt upgrade -y # Оновлюємо системні пакети
              

  Це можна робити раз на тиждень або раз на місяць. Після великих оновлень ядра або системних бібліотек може знадобитися перезавантаження сервера (sudo reboot). Плануйте ці перезавантаження також у вікно обслуговування.
• Оновлення Docker: Оновлення Docker Engine також здійснюється через apt upgrade. Після оновлення Docker Engine рекомендується перезапустити всі контейнери.

Підтримуйте журнал змін та версій для всіх компонентів, це допоможе при пошуку та усуненні неполадок.

Вирішення проблем + FAQ

Mealie не запускається, контейнери постійно перезавантажуються. Що робити?

Це часта проблема. Спочатку перевірте логи контейнера Mealie. Перейдіть до директорії, де знаходиться docker-compose.yml (~/mealie), і виконайте: docker compose logs mealie. Шукайте помилки, такі як проблеми з базою даних, відсутні змінні оточення, помилки файлової системи або невірні права доступу. Переконайтеся, що файл .env коректно налаштований, особливо SECRET_KEY та PUID/PGID.

Не можу отримати доступ до Mealie по HTTPS через домен.

Перевірте кілька речей: 1) Чи правильно налаштований A-запис у DNS для вашого домену і чи вказує він на IP вашого VPS? Використовуйте dig your.domain.com або онлайн-інструменти. 2) Чи працює Caddy? Перевірте логи Caddy: docker compose logs caddy. Шукайте помилки при отриманні сертифіката Let's Encrypt (наприклад, "certificate acquisition failed"). Переконайтеся, що порти 80 і 443 відкриті в UFW (sudo ufw status). Можливо, Caddy не може зв'язатися з Mealie, перевірте ім'я сервісу в Caddyfile (має бути mealie:9000).

Який VPS-конфіг мінімально підійде для Mealie?

Для Mealie, що використовується однією людиною або невеликою родиною, мінімально достатньо VPS з 1 ядром CPU, 1 GB RAM та 20-30 GB SSD. Цього вистачить для операційної системи, Docker та самого Mealie зі SQLite. Однак, для більш комфортної роботи та запасу на майбутнє, рекомендується 2 ядра CPU, 2 GB RAM та 50 GB SSD.

Що вибрати — VPS чи dedicated сервер для цього завдання?

Для Mealie практично завжди достатньо VPS. Dedicated сервери надлишкові за потужністю та вартістю для такого застосунку, якщо тільки ви не плануєте обслуговувати дуже велику кількість користувачів (сотні або тисячі, що нетипово для Mealie) або якщо у вас вже є dedicated сервер для інших високонавантажених завдань і ви хочете розмістити Mealie на ньому. VPS пропонує кращу гнучкість та економічність для більшості випадків.

Як оновити Mealie до нової версії?

Для оновлення Mealie, запущеного через Docker Compose, перейдіть до директорії ~/mealie. Потім виконайте docker compose pull, щоб завантажити нові образи. Після цього запустіть docker compose up -d, щоб перестворити контейнери з новими образами. Перед оновленням завжди рекомендується переглянути офіційну документацію Mealie на GitHub, оскільки можуть бути критичні зміни або кроки міграції між мажорними версіями.

Я забув пароль адміністратора Mealie. Як його скинути?

У Mealie 2.x ви можете скинути пароль адміністратора, використовуючи утиліту командного рядка всередині контейнера. Спочатку знайдіть ім'я або ID запущеного контейнера Mealie: docker ps | grep mealie. Потім виконайте команду скидання пароля, замінивши mealie-container-name на ім'я вашого контейнера та new_password на бажаний новий пароль:

docker exec -it mealie-container-name python src/app/main.py users reset-password admin --new-password new_password
    

Переконайтеся, що ви використовуєте правильне ім'я контейнера та ім'я користувача (admin за замовчуванням).

Як змінити порт, на якому працює Mealie всередині Docker?

За замовчуванням Mealie слухає порт 9000. Якщо вам потрібно змінити цей порт, ви можете відредагувати файл docker-compose.yml. Знайдіть сервіс mealie та змініть порт, який він слухає, у секції ports або у змінній оточення PORT у файлі .env. Якщо ви зміните внутрішній порт Mealie, вам також потрібно буде оновити конфігурацію Caddy (reverse_proxy mealie:НОВИЙ_ПОРТ), щоб він вказував на новий порт.

Висновки та наступні кроки

Вітаємо! Ви успішно встановили та налаштували Mealie на вашому VPS, забезпечивши безпечний доступ через HTTPS та реалізувавши стратегію резервного копіювання. Тепер у вас є потужний та гнучкий інструмент для керування вашою колекцією рецептів, повністю під вашим контролем. Це не тільки впорядкує ваші кулінарні нотатки, а й дасть цінний досвід в адмініструванні серверів та розгортанні застосунків з використанням Docker.

В якості наступних кроків ви можете розглянути:

• Налаштування моніторингу: Інтегруйте ваш VPS із системами моніторингу, такими як Prometheus + Grafana, для відстеження використання ресурсів та продуктивності Mealie.
• Оптимізація продуктивності: Якщо ваша колекція рецептів значно зросте, розгляньте можливість міграції на PostgreSQL для бази даних, що може покращити продуктивність порівняно зі SQLite.
• Інтеграція з іншими сервісами: Вивчіть можливості інтеграції Mealie з іншими домашніми сервісами, такими як планувальники завдань або розумні асистенти, для автоматизації кулінарних процесів.
• Посилення безпеки: Додайте двофакторну автентифікацію для доступу до Mealie, якщо це доступно в майбутніх версіях, або розгляньте налаштування VPN для доступу до VPS.