К содержимому

Nextcloud в Docker: пошаговая инструкция для Ubuntu 24.04

Nextcloud в Docker поднимается одним compose-файлом с сервисами приложения, базы MariaDB и Redis. На Ubuntu 24.04 достаточно установленного Docker с плагином Compose v2.

Руководство Docker 2 мин чтения

01Проверьте Docker и Compose

На сервере уже должен быть установлен Docker с плагином Compose v2. Убедитесь, что команда docker compose доступна и работает без sudo. Если Docker не установлен, его ставят из репозитория Docker пакетами docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin и docker-compose-plugin.

bash
docker --version
docker compose version
docker compose config

02Создайте каталог проекта

Создайте отдельный каталог для Nextcloud и перейдите в него. В этом каталоге будут лежать compose.yaml и данные, которые переживут перезапуск контейнеров. Именованные тома Docker хранит вне каталога проекта.

bash
mkdir -p /opt/nextcloud
cd /opt/nextcloud

03Напишите compose-файл

Создайте файл compose.yaml с тремя сервисами: app, db и redis. Порт приложения публикуйте только на localhost: 127.0.0.1:8080:80, чтобы Nextcloud не был открыт всему интернету. База доступна приложению по имени сервиса db:3306, Redis по имени redis:6379.

04Проверьте compose-файл

Команда docker compose config проверяет YAML и печатает итоговый конфиг. Ошибки отступов и кавычек видны сразу, например yaml: line 12: did not find expected key. Отступы делайте пробелами, табуляция недопустима.

bash
docker compose config

05Запустите контейнеры

Запустите сервисы в фоне. Docker скачает образы Nextcloud, MariaDB и Redis и создаст сеть проекта. Если порт 8080 уже занят, появится ошибка Bind for 0.0.0.0:8080 failed: port is already allocated, и занявший порт процесс покажет sudo ss -ltnp.

bash
docker compose up -d
docker compose ps

06Проверьте работу Nextcloud

Откройте в браузере http://127.0.0.1:8080 через SSH-туннель или локальный прокси. При первом входе создайте администратора и укажите базу MariaDB с хостом db. Логи приложения смотрите командой docker compose logs -f app.

bash
curl -I http://127.0.0.1:8080
docker compose logs -f app

Частые ошибки

  • Порт опубликован как 8080:80, и Nextcloud открыт всему интернету в обход UFW.

    Публикуйте порт только на localhost: 127.0.0.1:8080:80. Доступ извне настраивайте через обратный прокси на самом сервере.

  • В MYSQL_HOST указан localhost, и приложение не находит базу.

    В сети проекта сервисы видны по именам: укажите MYSQL_HOST: db и порт 3306 по умолчанию.

  • Контейнер завершается с кодом 137.

    Код 137 значит SIGKILL, чаще всего из-за нехватки памяти. Ограничьте память через deploy.resources.limits.memory или добавьте RAM серверу.

  • docker compose пишет permission denied while trying to connect to the Docker daemon socket.

    Добавьте пользователя в группу docker командой sudo usermod -aG docker $USER и войдите заново.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Как открыть Nextcloud из браузера, если порт слушает только 127.0.0.1?

Используйте SSH-туннель ssh -L 8080:127.0.0.1:8080 user@203.0.113.10 и откройте http://127.0.0.1:8080 на своём компьютере. Для постоянного доступа поставьте на сервере обратный прокси, например nginx.

Где Nextcloud хранит файлы и базу?

Файлы лежат в томе nextcloud_data, база в томе db_data. Тома переживают docker compose down, а удаляет их только docker compose down -v.

Нужен ли ключ version в compose-файле?

Нет. В Compose v2 ключ version: устарел и вызывает только предупреждение. Файл можно называть compose.yaml.

Что делать при ошибке no configuration file provided: not found?

Команда запущена не в каталоге проекта. Перейдите в каталог с compose.yaml или укажите путь через -f.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.