From 91afa07b4e00c92c9259ecc96a3db4c44318e154 Mon Sep 17 00:00:00 2001 From: Willy Kloucek Date: Tue, 21 Dec 2021 17:16:40 +0100 Subject: [PATCH 1/2] update getting started --- docs/ocis/getting-started/_index.md | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/docs/ocis/getting-started/_index.md b/docs/ocis/getting-started/_index.md index 92e00c4390..d86dda95d3 100644 --- a/docs/ocis/getting-started/_index.md +++ b/docs/ocis/getting-started/_index.md @@ -33,21 +33,25 @@ You can find the latest official release of oCIS at [our download mirror](https: The latest build from the master branch can be found at [our download mirrors testing section](https://download.owncloud.com/ocis/ocis/testing/). 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: +For this example, assuming version 1.16.0 of oCIS running on a Linux AMD64 host: ```console # download -curl https://download.owncloud.com/ocis/ocis/1.13.0/ocis-1.13.0-linux-amd64 --output ocis +curl https://download.owncloud.com/ocis/ocis/1.16.0/ocis-1.16.0-linux-amd64 --output ocis # make binary executable chmod +x ocis # run -./ocis server +OCIS_INSECURE=true ./ocis server ``` The default primary storage location is `~/.ocis` or `/var/lib/ocis` depending on the packaging format and your operating system user. You can change that value by configuration. +{{< hint info >}} +When you're using oCIS with self-signed certificates, you need to set the environment variable `OCIS_INSECURE=true`, in order to make oCIS work. +{{< /hint >}} + {{< hint warning >}} 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. {{< /hint >}} @@ -60,9 +64,18 @@ The `latest` tag always reflects the current master branch. ```console docker pull owncloud/ocis -docker run --rm -ti -p 9200:9200 owncloud/ocis +docker run --rm -ti -p 9200:9200 -e OCIS_INSECURE=true owncloud/ocis ``` +{{< hint info >}} +When you're using oCIS with self-signed certificates, you need to set the environment variable `OCIS_INSECURE=true`, in order to make oCIS work. +{{< /hint >}} + +{{< hint warning >}} +In order to persist your data, you need to mount a docker volume or create a host bind-mount at `/var/lib/ocis`, for example with: `-v /some/host/dir:/var/lib/ocis` + +{{< /hint >}} + ## Usage ### Login to ownCloud Web From 4cbc42aeb475259f4236936774139f3ac51fbc50 Mon Sep 17 00:00:00 2001 From: Willy Kloucek Date: Wed, 22 Dec 2021 11:38:21 +0100 Subject: [PATCH 2/2] add not about bind mounts on Mac --- docs/ocis/getting-started/_index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/ocis/getting-started/_index.md b/docs/ocis/getting-started/_index.md index d86dda95d3..bed607c4b5 100644 --- a/docs/ocis/getting-started/_index.md +++ b/docs/ocis/getting-started/_index.md @@ -74,6 +74,7 @@ When you're using oCIS with self-signed certificates, you need to set the enviro {{< hint warning >}} In order to persist your data, you need to mount a docker volume or create a host bind-mount at `/var/lib/ocis`, for example with: `-v /some/host/dir:/var/lib/ocis` +You cannot use bind mounts on MacOS, since extended attributes are not supported ([owncloud/ocis#182](https://github.com/owncloud/ocis/issues/182), [moby/moby#1070](https://github.com/moby/moby/issues/1070)). {{< /hint >}} ## Usage