Basic Remote Setup
The default configuration of the oCIS binary and the
owncloud/ocis docker image assume, that you access oCIS on
localhost. This enables you to do quick testing and development without any configuration.
If you need to access oCIS running in a docker container, on a VM or a remote machine via an other hostname than
localhost, you need to configure this hostname in oCIS. The same applies if you are not using hostnames but instead an IP (eg.
Upon first start of the oCIS fullstack server with
./bin/ocis server it will generate a file
identifier-registration.yml in the config folder in your current working directory. This file is used to configure the built-in identity provider and therefore contains the OpenID Connect issuer and also information about relying parties, for example ownCloud Web and our desktop and mobile applications.
identifier-registration.ymlfile will only be generated if it does not exist yet. If you want to change certain environment variables like
OCIS_URL, please delete this file first before doing so. Otherwise your changes will not be applied correctly and you will run into errors.
oCIS is currently in a Tech Preview state and is shipped with demo users. In order to secure your oCIS instances please follow following guide: secure an oCIS instance
For the following examples you need to have the oCIS binary in your current working directory, we assume it is named
ocis and it needs to be marked as executable. See Getting Started for where to get the binary from.
In order to run oCIS with automatically generated and self signed certificates please execute following command. You need to replace
your-host with an IP or hostname. Since you have only self signed certificates you need to have
OCIS_INSECURE set to
OCIS_INSECURE=true \ PROXY_HTTP_ADDR=0.0.0.0:9200 \ OCIS_URL=https://your-host:9200 \ ./ocis server
If you have your own certificates already in place, you may want to make oCIS use them:
OCIS_INSECURE=false \ PROXY_HTTP_ADDR=0.0.0.0:9200 \ OCIS_URL=https://your-host:9200 \ PROXY_TRANSPORT_TLS_KEY=./certs/your-host.key \ PROXY_TRANSPORT_TLS_CERT=./certs/your-host.crt \ ./ocis server
If you generated these certificates on your own, you might need to set
For more configuration options check the configuration section in oCIS and the oCIS extensions.
Please have a look at our other deployment examples.