# Module management

Additional modules allow you to expand the functionality of the main system. In this guide, you will find information on managing modules and installing applications using the built-in Marketplace.

{% hint style="info" %}
To use both paid and free modules, you need to register your copy of MikoPBX and obtain a free license key. Instructions on how to do this can be found [here](https://docs.mikopbx.com/mikopbx/english/manual/modules/licensing).
{% endhint %}

Detailed instructions for configuring and operating each module can be found [here](https://docs.mikopbx.com/mikopbx/english/modules/miko).

You can find the Module Management section under **"Modules"** -> **"Marketplace of modules"**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FOk1k34DZaT6xhOwmHVuD%2FmarketplaceOfModulesSection.png?alt=media&#x26;token=2ffbd877-1171-4a04-9ea0-4ccc49a26144" alt=""><figcaption><p>"Marketplace of modules" section</p></figcaption></figure>

## Installed Modules

This section allows you to manage modules: connecting them, configuring them, and uploading your own custom modules. Documentation on developing your own modules can be found [here](https://docs.mikopbx.com/mikopbx-development).

All installed modules are listed under the tab of the same name:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FcQ0hbMnnAqXUPgWmCoyd%2FallModules.png?alt=media&#x26;token=293d52b5-8cad-45be-b00f-ab9db179bb36" alt=""><figcaption><p>All installed modules</p></figcaption></figure>

You can upload your own module using the **"Upload New Module"** button. You need to upload `.zip` files. After uploading, the module will appear in the list under the "**Installed Modules**" tab.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FxOAjLXiu3mve7tNlCwnr%2FuploadNewModuleBtn.png?alt=media&#x26;token=04a759bc-28ba-4fc9-9c95-c32e583e39b0" alt=""><figcaption><p>"Upload new module" button</p></figcaption></figure>

You can also access the settings of any module for further configuration:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FXnWu9BpOytWOBTWQ5QGm%2FeditModule.png?alt=media&#x26;token=39bfb252-bd6a-446e-9b42-2da98b411adc" alt=""><figcaption><p>Module settings</p></figcaption></figure>

Additionally, you can enable or disable a module.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FS0T3HrCF1fvkyBtMyZqi%2FenableDisable.png?alt=media&#x26;token=29a3156f-3a39-4a87-b39f-e6767c451007" alt=""><figcaption><p>Enable/disable module</p></figcaption></figure>

From the interface of an installed module, you can quickly access its documentation by clicking on the question mark to the right of the module's short description:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FsJLR4LPJzb5iDxQjuRrj%2FinfoBtn.png?alt=media&#x26;token=f1d218ed-5add-4abd-8d64-79e56c2455c6" alt=""><figcaption><p>Quick jump to module documentation</p></figcaption></figure>

## Quick Access to Modules

You can add any module to the sidebar menu for quick access, which can be useful if you need constant access to the module's settings to change parameters or its status.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FIUZh1xFB0M307dT1Urvg%2FmodulesInTheNavMenu.png?alt=media&#x26;token=31606bcd-2e85-45f2-a69c-0e719bbacf36" alt=""><figcaption><p>Modules in quick access</p></figcaption></figure>

To do this, follow these instructions:

1. Go to the settings of the module you want to add to the sidebar menu by clicking on the edit icon to the right of the module's version:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FepOZ1ktgo7M7X573L4Kj%2FeditModule2.png?alt=media&#x26;token=b443ce00-6435-4c0b-88e5-08108c4844ca" alt=""><figcaption><p>Go to module settings</p></figcaption></figure>

2. Click on the settings icon to the right of the module's status to access the display settings for the module in the sidebar menu:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fm5nJZAoQFzH8YTtESKuT%2FsettingsInModule.png?alt=media&#x26;token=7edb646c-17a0-4464-a720-2100158df982" alt=""><figcaption><p>Settings of the module</p></figcaption></figure>

3. In this section, you can:

* Toggle the display of the module in the sidebar menu—**"Show module in sidebar menu"**.
* Choose the section where it will be displayed—in the example, the **"Modules"** section is selected.
* Specify a custom name for the module if desired.

After completing the settings, click **"Save"**.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FXp0thCXU8nGIguXwNfrs%2FparametersOfQuickAccess.png?alt=media&#x26;token=e0a47ec4-5417-4ca2-94e8-a171554c60ee" alt=""><figcaption><p>Module display options in the side menu</p></figcaption></figure>

## Marketplace

In this section, you can install modules from MIKO as well as from partner developers.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F73lINx75W7olguOHG8b5%2FmarketplaceSection.png?alt=media&#x26;token=7275891e-ae43-47c6-be3a-e424620a34fb" alt=""><figcaption><p>Marketplace section</p></figcaption></figure>

Each module has a button for downloading and installing it. Basic information about the module with a short description is also displayed here.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FviLAmVBNQTF9FDoxbC6G%2FinstallationMuduleButton.png?alt=media&#x26;token=d9aca3f2-3609-4200-8599-f000fb688aa8" alt=""><figcaption><p>Button for installing the module</p></figcaption></figure>

To the left of the module's name, you can find an icon indicating whether it is paid or free. For example, in the image above, the **"Access Control Management"** module is paid, while the **"Backup\&Recovery module"** module is free.

{% hint style="info" %}
Each paid module has a trial period of 2 weeks. During this period, you can try the module's functionality and decide whether to purchase it. To purchase a module, write to [**sale@mikopbx.com**](mailto:sale@mikopbx.com)
{% endhint %}

## Module Card

You can access a module's detailed page by clicking on its name in the Marketplace interface.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FuXzMl20grCPEkLQnifDE%2FcardOfModule.png?alt=media&#x26;token=78f8511f-dccc-4ede-b89e-b5891332d7c0" alt=""><figcaption><p>Module card</p></figcaption></figure>

Here you can find the version of the current release, information about the developer, and whether the module is paid or free. There are also three sections:

**Module Description**

This section contains images illustrating the module's functionality and settings. Additionally, there is a basic description of the module and a **"Useful Links"** section with a link to detailed documentation on configuring and operating the module.

**Version History**

In this section, you can find the module's version history with detailed descriptions of changes, as well as the minimum compatible version of MikoPBX for proper operation. You can also install a specific version of the module by clicking on the blue link under its description.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FJFfgDKnr2VPvd98mCMHm%2FversionHistory.png?alt=media&#x26;token=d726c96c-e5a3-48bc-870b-eee1681c0827" alt=""><figcaption><p>Version History section</p></figcaption></figure>

## Activating Coupons

If you purchase a module, you will receive a coupon. To activate it, go to **Modules -> Marketplace of modules**:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FOk1k34DZaT6xhOwmHVuD%2FmarketplaceOfModulesSection.png?alt=media&#x26;token=2ffbd877-1171-4a04-9ea0-4ccc49a26144" alt=""><figcaption><p>Marketplace of modules section</p></figcaption></figure>

Then navigate to the **"License Management"** section.

In the **"Activate Coupon"** field, enter your coupon code and click **"Activate Coupon"**

{% hint style="info" %}
The protection key always starts with **MIKO-**. Coupons for modifying product composition always start with **MIKOUPD-**.&#x20;
{% endhint %}

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FqZf9t1rYrEyxRmH38qFZ%2FcouponActivation.png?alt=media&#x26;token=a1346fab-81d7-4031-8388-39adaf6ebd73" alt=""><figcaption><p>Coupon activation</p></figcaption></figure>
