From 3d659054b33b7b52bb7db46dc1518ad6bfce25a3 Mon Sep 17 00:00:00 2001 From: Philipp Bielefeldt Date: Sat, 2 Sep 2023 16:29:36 +0200 Subject: [PATCH 1/2] create guid_owncloud_infinite_scale.rst basically taken from https://owncloud.com/news/hosting-infinite-scale-uberspace-ubernauten/ --- source/guid_owncloud_infinite_scale.rst | 102 ++++++++++++++++++++++++ 1 file changed, 102 insertions(+) create mode 100644 source/guid_owncloud_infinite_scale.rst diff --git a/source/guid_owncloud_infinite_scale.rst b/source/guid_owncloud_infinite_scale.rst new file mode 100644 index 00000000..4f8e4681 --- /dev/null +++ b/source/guid_owncloud_infinite_scale.rst @@ -0,0 +1,102 @@ +.. highlight:: console + +.. author:: TPhilipp Bielefeldt + +.. tag:: golang +.. tag:: web +.. tag:: groupware +.. tag:: file-storage +.. tag:: sync +.. tag:: photo-management + +##### +ownCloud Infinite Scale +##### + +.. tag_list:: + +ownCloud Infinite Scale is a File Storage and Collaboration software written in Go. +It is distributed under the Apache-2.0 license by ownCloud GmbH. + +---- + +.. note:: For this guide you should be familiar with the basic concepts of + + * :manual:`domains ` + +Prerequisites +============= + +Before installing oCIS, make sure you have a domain ready. +Also, note that oCIS expects port 9200 to be available, which by default is blocked on uberspace. +Hence, you have to configures nginX to forward all requests to port 9200 of the local machine. + +.. code-block:: console + + [isabell@stardust ~]$ uberspace web domain add myowncloud.isabell.uber.space + [isabell@stardust ~]$ uberspace web backend set myowncloud.isabell.uber.space --http --port 9200 + +.. include:: includes/web-domain-list.rst + +Since there is no local service running to answer port 9200, the "NOT OK" status you'll receive is to be expected here. + +Now, download the latest version of oCIS from `ownCloud's website `_. + +.. code-block:: console + + [isabell@stardust ~]$ curl https://download.owncloud.com/ocis/ocis/stable/4.0.1/ocis-4.0.1-linux-amd64 --output ocis + [isabell@stardust ~]$ chmod +x ocis + + +Init +==== + +You need to set some parameters in order to get oCIS running: + +.. code-block:: console + + [isabell@stardust ~]$ export OCIS_URL=https://myowncloud.isabell.uber.space + [isabell@stardust ~]$ export PROXY_TLS=false + [isabell@stardust ~]$ export PROXY_HTTP_ADDR=0.0.0.0:9200 + [isabell@stardust ~]$ export PROXY_LOG_LEVEL=warn + +(This is for an inital trial set-up; later, add these to your .bashrc for instance.) +For information on the available settings, have a look at `the documentation `_. + +Now, you can initialise your oCIS. + +.. code-block:: console + + [isabell@stardust ~]$ ./ocis init + Do you want to configure Infinite Scale with certificate checking disabled? + This is not recommended for public instances! [yes | no = default] no + + ========================================= + generated OCIS Config + ========================================= + configpath : /home/isabell/.ocis/config/ocis.yaml + user : admin + password : ****** + +Safe the admin password you received. + + +Run Server +========== + +Now, you should be ready to fire up the ownCloud Infinite Scale server. +You can do that by running + +.. code-block:: console + + [isabell@stardust ~]$ ./ocis server & + +Go to the URL you entered above (i.e. myowncloud.isabell.uber.space in this example). + +You should be presented with the ownCloud login mask. +Enter the user ("admin") and password you got from the init step. + +You should now be logged in as an administrator. +From here, you can use the Application Switcher to get to the Administration Settings. +There, create a new user as you like. +Use this user account to investigate the you own ownCloud. From e1e91d8101ca332f3e229cb6b6c0e93559f3fc6b Mon Sep 17 00:00:00 2001 From: Philipp Bielefeldt Date: Wed, 20 Sep 2023 22:04:17 +0200 Subject: [PATCH 2/2] add daemon --- ....rst => guide_owncloud_infinite_scale.rst} | 52 ++++++++++++++----- 1 file changed, 40 insertions(+), 12 deletions(-) rename source/{guid_owncloud_infinite_scale.rst => guide_owncloud_infinite_scale.rst} (78%) diff --git a/source/guid_owncloud_infinite_scale.rst b/source/guide_owncloud_infinite_scale.rst similarity index 78% rename from source/guid_owncloud_infinite_scale.rst rename to source/guide_owncloud_infinite_scale.rst index 4f8e4681..5bf89d14 100644 --- a/source/guid_owncloud_infinite_scale.rst +++ b/source/guide_owncloud_infinite_scale.rst @@ -28,25 +28,35 @@ Prerequisites ============= Before installing oCIS, make sure you have a domain ready. -Also, note that oCIS expects port 9200 to be available, which by default is blocked on uberspace. -Hence, you have to configures nginX to forward all requests to port 9200 of the local machine. + + +Now, download the latest version of oCIS from `ownCloud's website `_. .. code-block:: console - [isabell@stardust ~]$ uberspace web domain add myowncloud.isabell.uber.space - [isabell@stardust ~]$ uberspace web backend set myowncloud.isabell.uber.space --http --port 9200 + [isabell@stardust ~]$ curl https://download.owncloud.com/ocis/ocis/stable/4.0.1/ocis-4.0.1-linux-amd64 --output ~/bin/ocis + [isabell@stardust ~]$ chmod +x ~/bin/ocis -.. include:: includes/web-domain-list.rst -Since there is no local service running to answer port 9200, the "NOT OK" status you'll receive is to be expected here. +Service Daemon +============== -Now, download the latest version of oCIS from `ownCloud's website `_. +Create `~/etc/services.d/ocis.ini` -.. code-block:: console +.. code-block:: ini - [isabell@stardust ~]$ curl https://download.owncloud.com/ocis/ocis/stable/4.0.1/ocis-4.0.1-linux-amd64 --output ocis - [isabell@stardust ~]$ chmod +x ocis + [program:ocis] + environment= + OCIS_URL="https://myowncloud.isabell.uber.space", + PROXY_TLS="false", + PROXY_HTTP_ADDR="0.0.0.0:9200", + PROXY_LOG_LEVEL="warn" + command=ocis server + startsecs=30 + autostart=yes + autorestart=yes +.. include:: includes/supervisord.rst Init ==== @@ -67,7 +77,7 @@ Now, you can initialise your oCIS. .. code-block:: console - [isabell@stardust ~]$ ./ocis init + [isabell@stardust ~]$ ocis init Do you want to configure Infinite Scale with certificate checking disabled? This is not recommended for public instances! [yes | no = default] no @@ -91,7 +101,25 @@ You can do that by running [isabell@stardust ~]$ ./ocis server & -Go to the URL you entered above (i.e. myowncloud.isabell.uber.space in this example). +This will store all data in your ~/.ocis directory. + + +Port Forwarding +=============== + +Note that oCIS expects port 9200 to be available, which by default is blocked on uberspace. +Hence, you have to configures nginX to forward all requests to port 9200 of the local machine. + +.. code-block:: console + + [isabell@stardust ~]$ uberspace web domain add myowncloud.isabell.uber.space + [isabell@stardust ~]$ uberspace web backend set myowncloud.isabell.uber.space --http --port 9200 + +.. include:: includes/web-domain-list.rst + +Since there is no local service running to answer port 9200, the "NOT OK" status you'll receive is to be expected here. + +Now, go to the URL you entered above (i.e. myowncloud.isabell.uber.space in this example). You should be presented with the ownCloud login mask. Enter the user ("admin") and password you got from the init step.