aaron/nextcloud-docker
0
0
Fork 0
mirror of https://github.com/nextcloud/docker.git synced 2025-04-20 02:46:10 +02:00
Code Activity
nextcloud-docker/README.md
Aleksa Sarai 4eacdfd848
Dockerfile: use correct VOLUMEs 
The persistent data is just the contents of config/ (configuration),
apps/ (installed apps), and data/ (user data). The source code should
not be made into a volume because it will cause persistence issues when
you try to update an image.

Currently the existing setup means that standard Docker-style updates
(where you start a new Docker image) won't actually update the source
code -- causing confusion and other issues.

This matches how ownCloud's setup works as well.

Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
2017-01-25 02:03:34 +11:00

2.7 KiB
Raw Blame History

What is Nextcloud?

A safe home for all your data. Access & share your files, calendars, contacts, mail & more from any device, on your terms.

logo

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.

Start Nextcloud

Starting Nextcloud php-fpm instance listening on port 9000 is as easy as the following:

$ docker run -d indiehosters/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 Nextcloud setup wizard (appears on first run) allows connecting to an existing MySQL/MariaDB or PostgreSQL database. You can also link a database container, e.g. --link my-mysql:mysql, and then use mysql as the database host on setup.

Persistent data

All data beyond that which lives in the database (file uploads, etc) is stored within several volumes, which are all separately controlled (to ensure that the source code of NextCloud can be updated by switching Docker versions -- please always follow the correct upgrade process despite the ease of just switching images):

  • -v /<mydatalocation>/apps:/var/www/html/apps installed / modified apps
  • -v /<mydatalocation>/config:/var/www/html/config local configuration
  • -v /<mydatalocation>/data:/var/www/html/data the actual data of your Nextcloud

... via docker-compose

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.

$ docker pull indiehosters/nextcloud
$ docker run -d indiehosters/nextcloud

When you access your site the update wizard will show up.