Admin Guide
###########

Install
=======

Before we start you need to know the following:

* **ADSS** is a software distributed in a form of Docker Image.
* You have to have some Docker or compatible container engine to run **ADSS**.
* Current software version is not compatible with **SELinux**. Please consider to write your own **SELinux** policies or switch it off as described in :ref:`pre_requisites_`.

To install software you could simply run the following command:

.. code-block:: sh

  docker pull hub.arenadata.io/adss/core:latest

Then you have to create container base on that image. **ADSS** has some mandatory persistent information which is stored in */app/data* dir inside container. That means that we have to map volume to that dir and care about backup of that volume:

.. code-block:: sh

  docker create --name adss -p 8000:8000 -p 8443:8443 -v /opt/adss:/app/data hub.arenadata.io/adss/core:latest

In the command above we made a container on port ``8000`` with **ADSS** and all data will be stored on host machine in directory */opt/adsm/*.

.. _start_stop:

Start and Stop
==============

**ADSS** is just a container operated by Docker. So you are able to use simple Docker commands to start and stop **ADSS**.

To start Docker you need to use the following:

.. code-block:: sh

  docker start adss

After starting you will be able to login to **WebUI** over browser with url ``http://<ip_address_of_server>:8000``.

To stop the **ADSS** docker-container you need to issue the following:

.. code-block:: sh

  docker stop adss


Enable HTTPS
============

* Prepare server private key in pem format and place it to <data_volume>/conf/ssl/key.pem
* Prepare certificate chain and place it to <data_volume>/conf/ssl/cert.pem in PEM  format.
* Drop current adss container and create it with "ssl" port

.. code-block:: shell

   docker create --name adss -p 8000:8000 -p 8443:8443 -v /opt/adss:/app/data hub.arenadata.io/adss/core:latest


.. note::
   Order of certs in cert.pem should be in sync with Nginx documentation.