#######################
Debian packages install
#######################

IvozProvider is designed to be installed and updated using Debian packages.
More exactly, the current release is ready to be installed on
`Debian Bookworm 12 <https://www.debian.org/releases/bookworm>`_.

It's recommended to use one of the `official installation guides
<https://www.debian.org/releases/bookworm/installmanual>`_ to install the minimum
base system. The rest of required  dependencies will be installed automatically
with IvozProvider meta packages.

No matter if you are installing a :ref:`StandAlone install` or a
:ref:`Distributed install`, it's required to configure Irontec debian
repositories.

****************************
APT Repository configuration
****************************

.. code-block:: console

    cd /etc/apt/sources.list.d
    echo deb http://packages.irontec.com/debian tempest main extra > ivozprovider.list

Optionally, we can add the repository key to check signed packages:

.. code-block:: console

     wget http://packages.irontec.com/public.key -q -O /etc/apt/trusted.gpg.d/irontec-debian-repository.asc

.. _installing profile package:
.. _instalar el paquete del rol:

**************************
Installing profile package
**************************

Once the repositories are configured, it will be required to select the proper
metapackage depending on the type of installation.

- For a :ref:`StandAlone install`:
    - ivozprovider

.. code-block:: console

    apt-get update
    apt-get install ivozprovider

- For a :ref:`Distributed install`: one of the profile packages depending on the
  role the machine will perform.

    - ivozprovider-profile-data
    - ivozprovider-profile-proxy
    - ivozprovider-profile-portal
    - ivozprovider-profile-as

.. attention:: Distributed installation require a couple manual configuration based on the
   roles that are performing. Take into account that distributed installation process
   is not documented yet. You can refer to `documentation request
   <https://github.com/irontec/ivozprovider/issues/271>`_ for more information.

***********************
Finish the installation
***********************
Standalone installation have a menu that can be used to configure the basic
services used in IvozProvider. Most of the services are automatically configured
to work in the same machine with the default values.

This menu allows:

- Configure IP address(es) for SIP proxies
- Default platform language
- Administrator MySQL database password

It's possible to change any of this values anytime by running:

.. code-block:: console

    dpkg-reconfigure ivozprovider


.. important:: Any of the public IP addresses configured during the
   installation will work to access the web portal. Default credentials are
   **admin / changeme**.

.. important:: You must reboot your machine after a package installation in order to start
   all required services.