Skip Navigation

Search

Quickly get OCIS (Nextcloud alternative) up and running

To those self-hosters who are out there curious if there exists a faster Nextcloud-like alternative without all the bells and whistles. I present to you, OCIS! This howto assumes that you're running a Linux OS and that you have a reverse proxy like caddy running. To the guy who I suggested checking out OCIS, I wrote this guide for you ;)

1. Download the OCIS binary:

sudo wget -O /usr/bin/ocis https://download.owncloud.com/ocis/ocis/stable/3.0.0/ocis-3.0.0-linux-amd64

The above downloads the latest stable version.

2. Make the downloaded binary executable:

sudo chmod +x /usr/bin/ocis

3. Create a systemd unit file to start OCIS automatically:

``` Description=OCIS server

[Service] Type=simple User=ocis Group=ocis EnvironmentFile=/etc/ocis/ocis.env ExecStart=ocis server Restart=always

[Install] WantedBy=multi-user.target ``` 4. Create the ocis user:

sudo useradd --system --no-create-home --shell=/sbin/nologin ocis

5. Create the necessary directories:

sudo mkdir -p /etc/ocis /var/lib/ocis

6. Grant ownership of created directories above to the ocis user:

sudo chown -R ocis:ocis /etc/ocis/ /var/lib/ocis

7. Create the environment file for running OCIS:

sudo nano /etc/ocis/ocis.env and paste the lines below - edit the domain accordingly: OCIS_URL=https://ocis.your.domain.org PROXY_TLS=false OCIS_INSECURE=true OCIS_LOG_LEVEL=error OCIS_CONFIG_DIR=/etc/ocis OCIS_BASE_DATA_PATH=/var/lib/ocis PROXY_HTTP_ADDR=0.0.0.0:9200 PROXY_USER_OIDC_CLAIM=preferred_username PROXY_USER_CS3_CLAIM=username PROXY_ENABLE_BASIC_AUTH=true 8. Initialize your OCIS install:

sudo -u ocis ocis init --config-path /etc/ocis

That's it! Visiting the url https://ocis.your.domain.org should present you with OCIS login page. To access the webdav endpoint via something like Cx Explorer or Gnome files, use: https://ocis.your.domain.org/remote.php/webdav

Depending on your setup, you might have to add the ocis domain above to your hosts file. A line like 127.0.0.1 ocis.your.domain.org to the /etc/hosts file.

If you don't have a reverse proxy but would still like to check out OCIS, use the environment file below:

OCIS_URL=https://192.168.x.x:9200 PROXY_TLS=true OCIS_INSECURE=true OCIS_LOG_LEVEL=error OCIS_CONFIG_DIR=/etc/ocis OCIS_BASE_DATA_PATH=/var/lib/ocis PROXY_HTTP_ADDR=0.0.0.0:9200 PROXY_USER_OIDC_CLAIM=preferred_username PROXY_USER_CS3_CLAIM=username PROXY_ENABLE_BASIC_AUTH=true I tried mine with keli.local:9200 and it worked just fine- make sure you have avahi-daemon installed!

Edit: If you're using a reverse proxy, your proxy address should be localhost:9200. For caddy, this would mean an entry like:

ocis.your.domain.org { reverse_proxy localhost:9200 }

6