# 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 
```

