ownCloud
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

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 another hostname than localhost, you need to configure this hostname in oCIS. The same applies if you are not using hostnames but instead an IP (e.g. 192.168.178.25).

Start the oCIS fullstack server from binary

Initialize the oCIS configuration by running ./bin/ocis init.

Upon first start of the oCIS fullstack server with ./bin/ocis server it will generate a directory tree skeleton in $HOME/.ocis. If that is already existing it will not be overwritten as it contains all relevant data for oCIS.

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.

Using automatically generated certificates

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 true.

OCIS_INSECURE=true \
PROXY_HTTP_ADDR=0.0.0.0:9200 \
OCIS_URL=https://your-host:9200 \
./ocis server

Using already present certificates

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 OCIS_INSECURE to true.

For more configuration options check the configuration section in oCIS and the oCIS services.

Start the oCIS fullstack server with Docker Compose

Please have a look at our other deployment examples.