Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Nextcloud docker image

Docker Repository on Quay

Easy usable docker image for Nextcloud, the community fork of OwnCloud.


  • Uses latest stable version of Alpine Linux, bundled with PHP 7 and NGinx.
  • GPG check during building process.
  • APCu already configured.
  • LDAP support.
  • Cron runs all 15 mins (No need for web or AJAX cron).
  • Persistence for data, configuration and apps.
  • Nextcloud included apps that are persistent will be automatically updated during start.
  • Works with MySQL/MariaDB and PostgreSQL (server not included).
  • Supports uploads up to 10GB.
  • This image is also available via
  • NEW! Multi architecture support (x86,amd64,armv6,armv7,arm64,ppc64le,s390x)!

Container environment

Included software

  • Alpine Linux
  • PHP 7
  • APCu
  • NGinx
  • cron
  • SupervisorD

Everything is bundled in the newest stable version.


  • latest: Latest stable Nextcloud version (PHP 7)
  • X.X.X: Stable version tags of Nextcloud (e.g. v9.0.52) (Version >= 12.0.0 use PHP 7)
  • develop: Latest development branch (may unstable)
  • TAG-ARCHITECTURE (Example: develop-arm64): Tag with fixed processor architecture

Build-time arguments

  • NEXTCLOUD_GPG: Fingerprint of Nextcloud signing key
  • NEXTCLOUD_VERSION: Nextcloud version to install
  • UID: User ID of the nextcloud user (default 1501)
  • GID: Group ID of the nextcloud user (default 1501)

Exposed ports

  • 80: NGinx webserver running Nextcloud.


  • /data : All data, including config and user downloaded apps (in subfolders).



You can run Nextcloud without a separate database, but I don't recommend it for production setups as it uses SQLite. Another solution is to use an external database provided elsewhere, you can enter the credentials in the installer.

  1. Pull the image: docker pull rootlogin/nextcloud
  2. Run it: docker run -d --name nextcloud -p 80:80 -v my_local_data_folder:/data rootlogin/nextcloud (Replace my_local_data_folder with the path where do you want to store the persistent data)
  3. Open localhost and profit!

The first time you run the application, you can use the Nextcloud setup wizard to install everything. Afterwards it will run directly.

With a database container

For standard setups I recommend the use of MariaDB, because it is more reliable than SQLite. For example, you can use the offical docker image of MariaDB. For more information refer to the according docker image.

# docker pull rootlogin/nextcloud && docker pull mariadb:10
# docker run -d --name nextcloud_db -v my_db_persistence_folder:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=supersecretpassword -e MYSQL_DATABASE=nextcloud -e MYSQL_USER=nextcloud -e MYSQL_PASSWORD=supersecretpassword mariadb:10
# docker run -d --name nextcloud --link nextcloud_db:nextcloud_db -p 80:80 -v my_local_data_folder:/data rootlogin/nextcloud

The auto-connection of the database to nextcloud is not implemented yet. This is why you need to do that manually.


You can configure Nextcloud via the occ command:

# docker exec -ti nextcloud occ [...YOUR COMMANDS...]

The command uses the same user as the webserver.


Migrate from OwnCloud

You can easily migrate an existing OwnCloud to this Nextcloud docker image.

Before starting, always make a backup of your old OwnCloud instance. I told you so!

  1. Enable the maintenance mode on your old OwnCloud instance, e.g. sudo -u www-data ./occ maintenance:mode --on
  2. Create a new folder e.g. /var/my_nextcloud_data
  3. Create a new subfolder called "config" and copy the config.php from your existing instance in there.
  4. Copy your existing "data" folder to /var/my_nextcloud_data/data
  5. Start the docker container: docker run -d --name nextcloud -p 80:80 -v /var/my_nextcloud_data:/data rootlogin/nextcloud
  6. Wait until everything is running.
  7. Start the Nextcloud migration command: docker exec nextcloud occ upgrade
  8. Disable the maintenance mode of Nextcloud: docker exec nextcloud occ maintenance:mode --off
  9. Profit!

Run container with systemd

I usually run my containers on behalf of systemd, with the following config:

Description=Docker - Nextcloud container

ExecStart=/usr/bin/docker run -p -v /data/nextcloud:/data --name nextcloud rootlogin/nextcloud
ExecStop=/usr/bin/docker stop -t 2 nextcloud ; /usr/bin/docker rm -f nextcloud


NGinx frontend proxy

This container does not support SSL or similar and is therefore not made for running directly in the world wide web. You better use a frontend proxy like another NGinx.

Here are some sample configs (The config need to be adapted):

server {
	listen 80;

	# ACME handling for Letsencrypt
	location /.well-known/acme-challenge {
  	alias /var/www/letsencrypt/;
  	default_type "text/plain";
 		try_files $uri =404;

	location / {
  	return 301 https://$host$request_uri;

server {
  listen 443 ssl spdy;

	ssl_certificate /etc/;
  ssl_certificate_key /etc/;
  ssl_trusted_certificate /etc/;
	ssl_dhparam /etc/nginx/dhparam.pem;
	ssl_protocols TLSv1 TLSv1.1 TLSv1.2;

	ssl_session_cache shared:SSL:10m;
	ssl_session_timeout 30m;

	ssl_prefer_server_ciphers on;

	ssl_stapling on;
	ssl_stapling_verify on;

	add_header Strict-Transport-Security "max-age=31536000";

	access_log  /var/log/nginx/docker-nextcloud_access.log;
  error_log   /var/log/nginx/docker-nextcloud_error.log;

	location / {
    proxy_buffers 16 4k;
    proxy_buffer_size 2k;

    proxy_read_timeout 300;
    proxy_connect_timeout 300;
    proxy_redirect     off;

    proxy_set_header   Host              $http_host;
    proxy_set_header   X-Real-IP         $remote_addr;
    proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header   X-Frame-Options   SAMEORIGIN;

    client_max_body_size 10G;


Frequently Asked Questions

Why does the start take so long?

When you run the container it will reset the permissions on the /data folder. This means if you have much data, it takes some time. This helps to avoid permission issues.

Overwritten config

Some parameters in the Nextcloud configuration will be overwritten by the file in root/opt/nextcloud/config/docker.config.php

Group/User ID

You can change the numerical user id and group id via build arguments.

$ git clone && cd docker-nextcloud
$ docker build -t rootlogin/nextcloud --build-arg UID=1000 --build-arg GID=1000 .
$ docker run -p 80:80 rootlogin/nextcloud


This stuff is released under GPL. I'm happy about every pull-request, that makes this tool better.


If you want to donate for this project you can do it through Github Sponsorship.

Or you can send me some crypto-coins to the following address:

Bitcoin: bc1qvemyhud469qe4v6lcsn8sxu5e57m4sw3u2ujff