docs/owncloud
Docker Library Bot f637a27ab9 Run update.sh 2018-07-21 07:09:07 +00:00
..
README-short.txt Add docs for owncloud 2015-07-22 14:04:50 -06:00
README.md Run update.sh 2018-07-21 07:09:07 +00:00
content.md Add a new section in the PHP documentation about running as an arbitrary user 2018-05-08 10:53:25 -07:00
deprecated.md Deprecate our "ownCloud" image 2018-06-08 12:58:20 -07:00
github-repo Add github-repo file to every image repo 2016-05-12 16:33:19 -07:00
license.md Add docs for owncloud 2015-07-22 14:04:50 -06:00
logo.png Add docs for owncloud 2015-07-22 14:04:50 -06:00
maintainer.md Refactor the way information (especially links) are presented 2017-04-21 17:48:19 -07:00
stack.yml Add "restart: always" back to all our stack.yml examples (since it's only implied for stacks, not for compose) 2017-09-27 10:35:07 -07:00

README.md

DEPRECATION NOTICE

This image has been deprecated in favor of the official owncloud/server image provided, maintained, and supported by ownCloud upstream. The images found here will receive no further updates after 2018-12-31 (Dec 31, 2018). Please adjust your usage accordingly.

Supported tags and respective Dockerfile links

Quick reference

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. ownClouds 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 owncloud: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

... via docker stack deploy or docker-compose

Example stack.yml for owncloud:

# ownCloud with MariaDB/MySQL
#
# Access via "http://localhost:8080" (or "http://$(docker-machine ip):8080" if using docker-machine)
#
# During initial ownCloud setup, select "Storage & database" --> "Configure the database" --> "MySQL/MariaDB"
# Database user: root
# Database password: example
# Database name: pick any name
# Database host: replace "localhost" with "mysql"

version: '3.1'

services:

  owncloud:
    image: owncloud
    restart: always
    ports:
      - 8080:80

  mysql:
    image: mariadb
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example

Try in PWD

Run docker stack deploy -c stack.yml owncloud (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.

License

View license information for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

Some additional license information which was able to be auto-detected might be found in the repo-info repository's owncloud/ directory.

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.