tuzelko/nextcloud repository overview

⁠Nextcloud Docker

A Docker solution for self-hosting Nextcloud⁠ — a private cloud platform for file storage, sharing, and collaboration. Built on Alpine Linux with PHP and FreeUnit, configured entirely through environment variables.

⁠Why Nextcloud Docker?

• 🚀 Auto-configured – The container downloads Nextcloud on first start and generates all PHP config files from environment variables. No manual setup.
• 📦 Full stack included – Comes with MariaDB, Valkey (Redis-compatible cache), OnlyOffice Document Server, and Nextcloud Talk out of the box.
• 🔐 Secrets support – Sensitive variables (*_PASSWORD, *_SECRET) accept a _FILE suffix to load values from mounted secret files (Docker Swarm compatible).
• 🐳 Containerised – Run it anywhere Docker runs, with consistent behavior across environments.

⁠Prerequisites

• Docker (≥ 20.10)
• Docker Compose (≥ 2.0) or Docker Engine with docker compose plugin

⁠Quick Start

⁠1. Configure the Service

Download the docker-compose.yml⁠ file and place it in a convenient location on your disk.

Edit the file to set the required environment variables:

• NEXTCLOUD_DOMAINS – Comma-separated list of trusted domains (e.g. localhost,cloud.example.com).
• NEXTCLOUD_MAIN_DOMAIN – Primary domain used for URL generation (e.g. cloud.example.com).
• MARIADB_PASSWORD / MARIADB_ROOT_PASSWORD – MariaDB passwords.

For a full list of available variables see Configuration Reference⁠.

⁠2. Start the Service

docker compose up -d

On first start the container will download the latest Nextcloud release and configure itself automatically.

⁠3. Open Nextcloud

Navigate to https://cloud.example.com (or the domain you configured) and complete the web installer.

⁠4. Stop the Service

docker compose down

⁠5. Stop and Remove All Data

docker compose down -v

This deletes all Docker volumes (files, database, caches) — use with caution.

⁠Configuration Reference

⁠Required

⁠General

⁠Database (required for mysql / pgsql)

⁠Cache

⁠Mail

⁠Advanced Usage

⁠Pinning a Nextcloud Version

Set NEXTCLOUD_RELEASE_URL to a specific release ZIP:

NEXTCLOUD_RELEASE_URL=https://download.nextcloud.com/server/releases/nextcloud-30.0.0.zip

⁠Debugging

Run the container in foreground mode to see live logs:

docker compose up

Or check logs of a running service:

docker compose logs -f app

⁠Development & Debugging

A Makefile is included for developers. It simplifies building and managing the container.

⁠Available Make Commands

• make init – Copy .env.dist to .env.
• make clean – Remove unused Docker resources.
• make pull – Pull base images.
• make build – Build the Nextcloud Docker image.
• make push – Push the built image to a registry.
• make up – Start the service.
• make down – Stop the service.
• make down-with-volumes – Stop the service and delete volumes.
• make restart – Restart the service.

⁠License

This project is licensed under MIT license⁠.

Maintainer: Eugene Frost⁠ Repository: GitHub⁠ Registry: Docker HUB⁠

♥️ Issues and pull requests are welcome!