NextcloudEstimated reading time: 5 minutes
A safe home for all your data
GitHub repo: https://github.com/nextcloud/docker
This content is imported from the official Docker Library docs, and is provided by the original uploader. You can view the Docker Store page for this repo at https://store.docker.com/images/nextcloud.
Supported tags and respective
For detailed information about the published artifacts of each of the above supported tags (image metadata, transfer size, etc), please see the
repos/nextcloud directory in the
docker-library/repo-info GitHub repo.
For more information about this image and its history, please see the relevant manifest file (
library/nextcloud). This image is updated via pull requests to the
docker-library/official-images GitHub repo.
What is Nextcloud?
A safe home for all your data. Access & share your files, calendars, contacts, mail & more from any device, on your terms.
How to use this image
This image is designed to be used in a micro-service environment. It consists of the Nextcloud installation in an php-fpm container. To use this image it must be combined with any webserver that can proxy the http requests to the FastCGI-port of the container.
Starting Nextcloud php-fpm instance listening on port 9000 is as easy as the following:
$ docker run -d nextcloud
Now you can get access to fpm running on port 9000 inside the container. If you want to access it from the internet, we recommend using a reverse proxy in front. You can install it directly on your machine or use an additional container (You can find more information on that on the docker-compose section). Once you have a reverse proxy, you can access Nextcloud at http://localhost/ and go through the wizard.
By default this container uses SQLite for data storage, but the wizard allows connecting to an existing database. For a MySQL database you can link an database container, e.g.
--link my-mysql:mysql, and then use
mysql as the database host on setup.
All data beyond what lives in the database (file uploads, etc) is stored within the default volume
/var/www/html. With this volume, Nextcloud will only be updated when the file
version.php is not present.
For fine grained data persistence, you can use 3 volumes, as shown below.
-v /<mydatalocation>/apps:/var/www/html/appsinstalled / modified apps
-v /<mydatalocation>/config:/var/www/html/configlocal configuration
-v /<mydatalocation>/data:/var/www/html/datathe actual data of your Nextcloud
The recommended minimal setup is using this image in combination with two containers: A database container and a reverse proxy for the http connection to the service. A working example can be found at IndieHosters/Nextcloud.
If you want to access your Nextcloud from the internet we recommend configuring your reverse proxy to use encryption (for example via let’s Encrypt)
Update to a newer version
To update your Nextcloud version you simply have to pull and start the new container. (if you mounted the full
/var/www/html, you need to delete
version.php. See persistent data for more information.)
$ docker pull nextcloud $ docker run -d nextcloud
When you access your site, the update wizard will show up.
View license information for the software contained in this image.
Supported Docker versions
This image is officially supported on Docker version 17.04.0-ce.
Support for older versions (down to 1.6) is provided on a best-effort basis.
Please see the Docker installation documentation for details on how to upgrade your Docker daemon.
If you have any problems with or questions about this image, please contact us through a GitHub issue. If the issue is related to a CVE, please check for a
cve-tracker issue on the
official-images repository first.
You can also reach many of the official image maintainers via the
#docker-library IRC channel on Freenode.
You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.
Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.
Documentation for this image is stored in the
nextcloud/ directory of the
docker-library/docs GitHub repo. Be sure to familiarize yourself with the repository’s
README.md file before attempting a pull request.