crazy-max/docker-nextcloud
crazy-max/docker-nextcloud has 269 GitHub stars and 44 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-20 15:25 UTC. Last push 2026-11-14.
What you can do
- Run as non-root user
- Multi-platform image
- Tarball authenticity checked during building process
- Data, config, user apps and themes persistence in the same folder
Gemessener Sternzuwachs
- in 24h
- 0
- in 7 days
- Verlauf wird gesammelt
- in 15 days
- Verlauf wird gesammelt
- in 1 month
- Verlauf wird gesammelt
Nettoänderungen in überlappenden Zeiträumen, keine Tagessummen. Fehlende Messwerte bleiben leer. Sterne zeigen Interesse, nicht Qualität.
Über uns
Nextcloud Docker image
EntwicklerwerkzeugeREADME.md
OriginalAbout
Nextcloud Docker image with advanced features.
[!TIP] Want to be notified of new releases? Check out 🔔 Diun (Docker Image Update Notifier) project!
- Features
- Build locally
- Image
- Environment variables
- Volumes
- Ports
- Usage
- Upgrade
- Notes
- Contributing
- License
Features
- Run as non-root user
- Multi-platform image
- Tarball authenticity checked during building process
- Data, config, user apps and themes persistence in the same folder
- Automatic installation
- Cron task for Nextcloud background jobs as a sidecar cron container
- Execute pre-generation of previews through Preview Generator plugin
- OPCache enabled to store precompiled script bytecode in shared memory
- APCu installed and configured
- Memcached and Redis also enabled to enhance server performance
- Database connectors MySQL/MariaDB, PostgreSQL and SQLite3 enabled
- Exif, IMAP, LDAP, FTP, GMP, SMB enabled (required for specific apps)
- FFmpeg, iconv, Imagick installed for preview generation
- s6-overlay as process supervisor
- Traefik as reverse proxy and creation/renewal of Let's Encrypt certificates (see this template)
- msmtpd SMTP relay image to send emails
- Redis for caching
- MariaDB as database instance
Build locally
git clone https://github.com/crazy-max/docker-nextcloud.git
cd docker-nextcloud
# Build image and output to docker (default)
docker buildx bake
# Build multi-platform image
docker buildx bake image-all
Image
| Registry | Image |
|---|---|
| Docker Hub | crazymax/nextcloud |
| GitHub Container Registry | ghcr.io/crazy-max/nextcloud |
Following platforms for this image are available:
$ docker buildx imagetools inspect crazymax/nextcloud --format "{{json .Manifest}}" | \
jq -r '.manifests[] | select(.platform.os != null and .platform.os != "unknown") | .platform | "\(.os)/\(.architecture)\(if .variant then "/" + .variant else "" end)"'
linux/amd64
linux/arm64
linux/ppc64le
linux/riscv64
linux/s390x
Environment variables
General
TZ: The timezone assigned to the container (defaultUTC)PUID: Nextcloud user id (default1000)PGID: Nextcloud group id (default1000)MEMORY_LIMIT: PHP memory limit (default512M)UPLOAD_MAX_SIZE: Upload max size (default512M)PM_MAX_CHILDREN: Maximum number of child processes to be created for PHP-FPM (default20)NGINX_WORKER_PROCESSES: Number of Nginx worker processes (defaultauto)BODY_TIMEOUT: Defines a timeout for reading client request body (default300s)CLEAR_ENV: Clear environment in FPM workers (defaultyes)OPCACHE_MEM_SIZE: PHP OpCache memory consumption (default128)LISTEN_IPV6: Enable IPv6 for Nginx (defaulttrue)APC_SHM_SIZE: APCu memory size (default128M)REAL_IP_FROM: Trusted addresses that are known to send correct replacement addresses (default0.0.0.0/32)REAL_IP_HEADER: Request header field whose value will be used to replace the client address (defaultX-Forwarded-For)LOG_IP_VAR: Use another variable to retrieve the remote IP address for access log_format on Nginx. (defaultremote_addr)
Nextcloud
HSTS_HEADER: HTTP Strict Transport Security header value (defaultmax-age=15768000; includeSubDomains)XFRAME_OPTS_HEADER: X-Frame-Options header value (defaultSAMEORIGIN)RP_HEADER: Referrer Policy header value (defaultstrict-origin)DB_TYPE: Database type (mysql, pgsql or sqlite) (defaultsqlite)DB_NAME: Database name (defaultnextcloud)DB_USER: Username for database (defaultnextcloud)DB_PASSWORD: Password for database userDB_HOST: Database host (defaultdb)DB_TIMEOUT: Time in seconds after which we stop trying to reach the database server. Only used formysqlandpgsqldb type (default60)
[!NOTE]
DB_PASSWORD_FILEcan be used to fill in the value from a file, especially for Docker's secrets feature.
Cron
[!WARNING] Only used if you enable and run a sidecar cron container
SIDECAR_CRON: Set to1to enable sidecar cron mode (default0)CRON_PERIOD: Periodically execute Nextcloud cron (eg.*/5 * * * *)
Previews generator
[!WARNING] Only used if you enable and run a sidecar previews generator container
SIDECAR_PREVIEWGEN: Set to1to enable sidecar previews generator mode (default0)PREVIEWGEN_PERIOD: Periodically execute pre-generation of previews (eg.0 * * * *)
Volumes
/data: Contains config, data folders, installed user apps (not core ones), session, themes, tmp folders/data/config/*.config.php: Additional Nextcloud configuration files loaded from the persistent config directory
[!WARNING] Note that the volume should be owned by the user/group with the specified
PUIDandPGID. If you don't give the volume correct permissions, the container may not start.
Ports
8000: HTTP port
Usage
Docker Compose
Docker compose is the recommended way to run this image. Copy the content of
folder examples/compose in /var/nextcloud/ on your host
for example. Edit the compose and env files with your preferences and run the
following commands:
docker compose up -d
docker compose logs -f
Command line
You can also use the following minimal command:
docker run -d -p 8000:8000 --name nextcloud \
-v "$(pwd)/data:/data" \
crazymax/nextcloud:latest
Upgrade
To upgrade to the latest version of Nextcloud, pull the newer image and launch the container. Nextcloud will upgrade automatically:
docker compose pull
docker compose up -d
Notes
First installation
If you run the container for the first time, the installation will be automatic
using the DB_* environment variables. Then open your browser to configure
your admin account.
OCC command
If you want to use the occ command to perform common server operations like manage users, encryption, passwords, LDAP setting, and more, type:
docker compose exec nextcloud occ
Cron sidecar
If you want to enable the cronjob, you have to run a "sidecar" container (see cron service in compose.yml example) or run a simple container like this:
docker run -d --name nextcloud_cron \
--env-file $(pwd)/nextcloud.env \
-e "SIDECAR_CRON=1" \
-e "CRON_PERIOD=*/5 * * * *" \
-v "$(pwd)/data:/data" \
crazymax/nextcloud:latest
And do not forget to choose Cron as background jobs:

Previews generator sidecar
To execute pre-generation of previews through the Preview Generator plugin, you have to run a "sidecar" container (see cron service in compose.yml example) or run a simple container like this:
docker run -d --name nextcloud_previewgen \
--env-file $(pwd)/nextcloud.env \
-e "SIDECAR_PREVIEWGEN=1" \
-e "PREVIEWGEN_PERIOD=0 * * * *" \
-v "$(pwd)/data:/data" \
crazymax/nextcloud:latest
Email server
You can use our SMTP relay msmtpd service published on port 2500 and
declared in our compose.yml:

Custom configuration
Nextcloud can load additional
*.config.php files
from its config directory.
Use /data/config/<name>.config.php for custom settings instead of editing
/data/config/config.php, which is managed by Nextcloud and this image.
These files are merged with config.php and take precedence over values defined
there. You can inspect the merged configuration with:
docker compose exec nextcloud occ config:list system --private
Do not store backup files ending with .config.php in /data/config, because
Nextcloud will load them as active configuration.
Redis cache
Redis is recommended, alongside APCu to make Nextcloud faster. If you want to
enable Redis, deploy a redis container (see compose file)
and create /data/config/redis.config.php:
<?php
$CONFIG = [
'memcache.local' => '\OC\Memcache\APCu',
'memcache.distributed' => '\OC\Memcache\Redis',
'memcache.locking' => '\OC\Memcache\Redis',
'redis' => [
'host' => 'redis',
'port' => 6379,
],
];
Running in a subdir
This image does not rewrite requests for subdir deployments. The bundled Nginx configuration expects requests to arrive at the root path it serves and emits root-relative redirects.
If you expose Nextcloud below a path prefix like /nextcloud, configure the
reverse proxy to own that routing. For example, strip /nextcloud before
forwarding requests to this container and handle any public redirects for that
prefix in the proxy configuration.
Configure Nextcloud's own URLs separately with a custom configuration file such
as /data/config/proxy.config.php:
<?php
$CONFIG = [
'overwritewebroot' => '/nextcloud',
];
CalDAV/CardDAV discovery uses root /.well-known/... URLs. If your reverse
proxy only routes /nextcloud/... to this container, also route those
/.well-known requests to Nextcloud or redirect them at the proxy to
/nextcloud/remote.php/dav/.
Remember to remove includeSubDomains from HSTS_HEADER if the prefixed
deployment does not cover all subdomains.
Contributing
Want to contribute? Awesome! The most basic way to show your support is to star the project, or to raise issues. You can also support this project by becoming a sponsor on GitHub or by making a PayPal donation to ensure this journey continues indefinitely!
Thanks again for your support, it is much appreciated! :pray:
License
MIT. See LICENSE for more details.
