We have an oCIS demo instance running on ocis.owncloud.com where you can get a first impression of it.
We also have some more variations of oCIS running and continuously deployed to reflect different scenarios in that oCIS might be used.
We are distributing oCIS as binaries and Docker images.
The examples in this document assume that oCIS is accessed from the same host as it is running on (
localhost). If you would like to access oCIS remotely please refer to the Basic Remote Setup section. Especially to the notes about setting the
You can find more deployment examples in the deployment section.
To run oCIS as binary you need to download it first and then run the following commands. For this example, assuming version 1.13.0 of oCIS running on a Linux AMD64 host:
# download curl https://download.owncloud.com/ocis/ocis/1.13.0/ocis-1.13.0-linux-amd64 --output ocis # make binary executable chmod +x ocis # run ./ocis server
The default primary storage location is
/var/lib/ocis depending on the packaging format and your operating system user. You can change that value by configuration.
oCIS by default relies on Multicast DNS (mDNS), usually via avahi-daemon. If your system has a firewall, make sure mDNS is allowed in your active zone.
Docker images for oCIS are available on Docker Hub.
latest tag always reflects the current master branch.
docker pull owncloud/ocis docker run --rm -ti -p 9200:9200 owncloud/ocis
The oCIS single binary contains multiple extensions and the
ocis command helps you to manage them. You already used
ocis server to run all available extensions in the Run oCIS section. We now will show you some more management commands, which you may also explore by typing
ocis --help or going to the docs.
To start oCIS server:
The list command prints all running oCIS extensions.
To stop a particular extension:
ocis kill web
To start a particular extension:
ocis run web
The version command prints the version of your installed oCIS.
The health command is used to execute a health check, if the exit code equals zero the service should be up and running, if the exist code is greater than zero the service is not in a healthy state. Generally this command is used within our Docker containers, it could also be used within Kubernetes.
ocis health --help