============
Installation
============

Requirements
============

innovaphone PBX with app platform at least in Version V14r1

App Installation
----------------

The App must be installed at the apps plattform.

Upload a new App with the ``Upload a new app`` Button.

.. thumbnail:: install_app.png

As soon as the installation has successfully been completed, app instances can be set up.


Configuration of Instances
==========================

Setting up Instances
--------------------

After the app has been installed, one or more instances can be set up.

The instance must be configured according to the system enviroment.

.. thumbnail:: install_create_instance__en.png

After setting up an instance, the app must be started by clicking the ``Start button``.
The instance will be listed as an app in the ``PBX Manager``.

Setting up PBX Objects
----------------------

On the PBX manager app a PBX object must be set up for admins for app access.

.. thumbnail:: install_add_app_pbx_manager__en.png
   :width: 185px
   :height: 60px

   Configuration in the PBX manager

The entries' names serve as annotation for the entries of myApps clients.
In this case, ``GrpApi Admin`` could be used as a possible name and for the SIP ``grpapiadmin``.

.. thumbnail:: install_add_app_pbx_manager_admin__en.png

   Configuration of the admin app in the PBX manager

The checkboxes represent all available templates. The associated user template is assigned to the user app and the associated admin template is assigned to the admin app. 
Green hooks will appear as soon as the app objects are displayed.
The apps are assigned to each user, who can then add it.


Configuration of the App
========================

In the app itself there are settings that must be set.

.. thumbnail:: configuration_app.png

- **Authtoken**: The Bearer token that should be used in HTTP Requests
- **Systemdomain**: The domain name of the pbx system
- **Master Pbx**: The master pbx in the system.

After setting this configuration values the App is ready to be used.