Nextcloud в Docker: пошаговая инструкция для Ubuntu 24.04
Nextcloud в Docker поднимается одним compose-файлом с сервисами приложения, базы MariaDB и Redis. На Ubuntu 24.04 достаточно установленного Docker с плагином Compose v2.
01Проверьте Docker и Compose
На сервере уже должен быть установлен Docker с плагином Compose v2. Убедитесь, что команда docker compose доступна и работает без sudo. Если Docker не установлен, его ставят из репозитория Docker пакетами docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin и docker-compose-plugin.
docker --version
docker compose version
docker compose config
02Создайте каталог проекта
Создайте отдельный каталог для Nextcloud и перейдите в него. В этом каталоге будут лежать compose.yaml и данные, которые переживут перезапуск контейнеров. Именованные тома Docker хранит вне каталога проекта.
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. Отступы делайте пробелами, табуляция недопустима.
docker compose config
05Запустите контейнеры
Запустите сервисы в фоне. Docker скачает образы Nextcloud, MariaDB и Redis и создаст сеть проекта. Если порт 8080 уже занят, появится ошибка Bind for 0.0.0.0:8080 failed: port is already allocated, и занявший порт процесс покажет sudo ss -ltnp.
docker compose up -d
docker compose ps
06Проверьте работу Nextcloud
Откройте в браузере http://127.0.0.1:8080 через SSH-туннель или локальный прокси. При первом входе создайте администратора и укажите базу MariaDB с хостом db. Логи приложения смотрите командой docker compose logs -f app.
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 docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы