first commit

1 files changed, 31 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 00000000..fb5a026d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+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](https://github.com/nextcloud/docker/blob/master/logo.png)
+
+# How to use this image
+
+## Start Nextcloud
+
+Starting the Nextcloud 9.0.53 instance listening on port 80 is as easy as the following:
+
+```console
+$ docker run -d -p 80:80 nextcloud:9.0.53
+```
+
+Then go to http://localhost/ and go through the wizard. By default this container uses SQLite for data storage, but the wizard should allow for 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.
+
+## Persistent data
+
+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.
+
+- `-v /<mydatalocation>:/var/www/html`
+
+For fine grained data persistence, you can use 3 volumes, as shown below.
+
+- `-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