diff --git a/source/guide_owncloud_infinite_scale.rst b/source/guide_owncloud_infinite_scale.rst new file mode 100644 index 00000000..5bf89d14 --- /dev/null +++ b/source/guide_owncloud_infinite_scale.rst @@ -0,0 +1,130 @@ +.. 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. + + +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 ~/bin/ocis + [isabell@stardust ~]$ chmod +x ~/bin/ocis + + +Service Daemon +============== + +Create `~/etc/services.d/ocis.ini` + +.. code-block:: ini + + [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 +==== + +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 & + +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. + +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.