docs/owncloud/content.md

What is ownCloud?

ownCloud is a self-hosted file sync and share server. It provides access to your data through a web interface, sync clients or WebDAV while providing a platform to view, sync and share across devices easily—all under your control. ownCloud’s open architecture is extensible via a simple but powerful API for applications and plugins and it works with any storage.

owncloud.org

%%LOGO%%

How to use this image

Start ownCloud

Starting the ownCloud 8.1 instance listening on port 80 is as easy as the following:

$ docker run -d -p 80:80 %%IMAGE%%:8.1

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. Additionally, tags for 6.0, 7.0, or 8.0 are available.

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, ownCloud 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 ownCloud

Caveat

When using the 6.0 image, you need to map the host port to the container port that apache listens on when going through the installation wizard. By default, this is port 80.

Using occ

The occ tool from upstream is simplest to use via docker exec, similar to the example provided there:

$ docker exec -u www-data some-owncloud php occ status

%%STACK%%

Run docker stack deploy -c stack.yml %%REPO%% (or docker-compose -f stack.yml up), wait for it to initialize completely, and visit http://swarm-ip:8080/, http://localhost:8080/, or http://host-ip:8080 (as appropriate).

Running as an arbitrary user

See the "Running as an arbitrary user" section of the php image documentation.