Initial QSfera import

Server/deployments/examples/bare-metal-simple/README.md

@@ -0,0 +1,79 @@
+# Simple Bare Metal Install
+
+This install script downloads and installs the КуСфера binary and
+configures it in a sandbox directory in the folder where you called
+the install script. It also adds a start script called `runqsfera.sh`
+to start КуСфера later.
+
+The installation only consists of the bare minimum functionality
+without web office and other optional components. Also, it is bound
+to localhost by default. **It is only useful for simple test- and
+demo cases and not for production.**
+
+To use КуСфера, start it with the start script and head your
+browser to http://localhost:9200.
+
+The demo users (eg. alan / demo) are enabled, the admin password
+is surprisingly `admin`.
+
+This script should **NOT** be run as user root.
+
+# Options
+
+## Version
+
+Set the environment variable `OC_VERSION` to the version you want
+to download. If not set, there is a reasonable default. 
+
+## Data Location
+
+Set the environment variable `OC_BASE_DIR` to a directory where the
+`data` and `config` subdirectories shall be located. Per default,
+both configuration and storage data are within a sandbox subdirectory
+in the current working directory.
+
+## Server Address
+
+Set the environment variable `OC_HOST` to the fully qualified hostname
+of this server to allow remote access. Default: `localhost`.
+
+## HTTPS
+
+The demo setup uses plain HTTP by default so browsers can open it
+without a certificate warning. If HTTPS is required, set `OC_TLS=true`
+before running the install script:
+
+```
+OC_TLS=true ./install.sh
+```
+
+In HTTPS mode the proxy creates a self-signed certificate unless
+`PROXY_TRANSPORT_TLS_CERT` and `PROXY_TRANSPORT_TLS_KEY` point to a
+certificate trusted by the browser. A self-signed certificate is useful
+for tests, but Chrome will show `ERR_CERT_AUTHORITY_INVALID` for it.
+
+For an existing demo install that should be reachable on a LAN address
+without a browser certificate warning, edit `runqsfera.sh` so the public
+URL and proxy TLS settings match the address:
+
+```
+export OC_URL=http://192.168.0.185:9200
+export PROXY_TLS=false
+```
+
+# Example
+
+Call
+
+```
+OC_VERSION="2.0.0" ./install.sh
+``` 
+to install the КуСфера version 2.0.0
+
+There is also a hosted version of this script that makes it even
+easier:
+
+```
+curl -L https://qsfera.eu/install.sh | bash -x 
+```
+