# Registration in the modules marketplace

## General Information

Registering in the MikoPBX Module Marketplace is not required for the system’s basic functionality. You can fully utilize MikoPBX for handling calls without registration or installing additional modules. However, we recommend registering in the marketplace to expand your system’s capabilities.

Registration gives you access to additional modules and extensions.\
These include both **free** modules (moved out of the core system for easier initial setup) and **paid** modules from us and third-party developers.\
If you are a developer, you can contact us at **<developers@mikopbx.com>** to get instructions on creating and adding your module to the Marketplace.

{% hint style="success" %}
MikoPBX is a free solution and does not require registration.\
The absence of a license does not impact call functionality. You can register or cancel your Marketplace registration anytime.
{% endhint %}

To begin the registration process, navigate 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%2FxqiowuvqV3olBG6pkrdL%2FmarketplaceOfModulesSectionNav.png?alt=media&#x26;token=7f0e4185-c62c-409d-8f6a-883c883fcd20" alt=""><figcaption><p>Section "<strong>Modules</strong>" -> "<strong>Marketplace of modules</strong>"</p></figcaption></figure>

If you are not registered in the Marketplace, the section will look as follows:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F3yjpPusIZEuAUE55jEXh%2FstartPageMarketplaceMikoPBX.png?alt=media&#x26;token=3e32ea0f-bb55-4e2a-b228-45b533d86421" alt=""><figcaption><p>Marketplace section if registration is not completed</p></figcaption></figure>

***

### Registration Process

{% hint style="warning" %}
If you move MikoPBX to another host or restore it from a backup, you will need to reset license bindings in the [License Manager](https://lm.mikopbx.com).
{% endhint %}

{% hint style="info" %}
One license key is issued per company. If your company uses multiple MikoPBX instances, a single registration is sufficient.
{% endhint %}

To start the registration process, click the **Register in Marketplace** button:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FGqmzKHqAaPKoHhX7vckR%2FregistrationBtn.png?alt=media&#x26;token=39826f3d-7c08-4a7c-951c-9609e0437a1e" alt=""><figcaption><p>The "<strong>Registration in the marketplace</strong>" button</p></figcaption></figure>

The license key stores all your licenses for MikoPBX products. If you already have a key, you can enter it in the corresponding field. If you've forgotten your key, search your email inbox for messages from **<lic@miko.ru>**

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fr4iIYtuwUZbD2w9EJ0NW%2FlicenceManagmentSection.png?alt=media&#x26;token=b62b8b29-3824-4fa2-981a-f28cf4457c0c" alt=""><figcaption><p>License key</p></figcaption></figure>

If you don’t have a key, you can generate a new one by completing the registration form:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FQT921ohtjyhEWqOIwlX8%2FregistrationField.png?alt=media&#x26;token=7188c4a9-54ce-48ba-9c3f-d66e5b7ead75" alt=""><figcaption><p>Registration form for the marketplace</p></figcaption></figure>

* **Organization Name** – Enter your company/organization name.
* **Contact Email** – Enter your organization’s email address.
* **Contact Person** – Enter the name of the contact person.
* **Contact Phone** (optional) – Provide a contact number.
* **Unique Company Identifier** (e.g., Tax ID, VAT) (optional).

Click **Register**.

Upon successful registration, you will see the following screen:

* A notification confirming the system's registration.
* The license key field will display a blurred value by default. Hover over it to view or copy the key.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FL2xh0i4CjIzAdGEmYfaV%2FsucessfulRegistration.png?alt=media&#x26;token=b930df11-aa13-4c67-9839-dd1dbb9490b5" alt=""><figcaption><p>Successful registration in the marketplace</p></figcaption></figure>

***

### License Management

To manage your license, go to **Marketplace -> License Management** and click the corresponding option:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FbwXkFrl5joAMFXJ99BCL%2FlicenseManagementBtn.png?alt=media&#x26;token=5b2c5406-c331-4214-88a9-a4db2fc48e35" alt=""><figcaption><p>"License Management" element</p></figcaption></figure>

You will be redirected to the [SaaS Licensing Server](https://lm.mikopbx.com/client-cabinet/session/index/):

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FqTD8D560C3cpBlI1iOAN%2FsaasOverallPage.png?alt=media&#x26;token=85c56cb1-e45b-4163-8406-e21406a2ac27" alt=""><figcaption><p>SaaS Licensing Server Page</p></figcaption></figure>

Enter your license key in the **Enter your license key or activated coupon** field and click **Login**:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FyFEflWKb7NsllndzkZ7c%2FloginBtn.png?alt=media&#x26;token=0060f6f2-374d-42aa-b149-2f644cb367cc" alt=""><figcaption><p>Entered license key</p></figcaption></figure>

You will access a system with nine sections:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fto6ZIaODsZpBUgdX9y0g%2FsaasInside.png?alt=media&#x26;token=010680ed-c56c-4bf6-b82b-86e3a9ffec57" alt=""><figcaption><p>SaaS System</p></figcaption></figure>

Go to the **Session monitor** section:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F1baRzd0FousMDnxmQpV2%2FsessionMonitorSection.png?alt=media&#x26;token=bc57b061-388d-44b2-b0e2-9bc786b06d61" alt=""><figcaption><p>"Session monitor" Section</p></figcaption></figure>

In the **Info** column, click the **i** button for each binding to view detailed host information.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FrvzTdNT9zLEUWyP3u1R2%2FinfoHost.png?alt=media&#x26;token=883c63e4-d176-4cbe-a391-4da86ad9fec6" alt=""><figcaption><p>Host information</p></figcaption></figure>

In the **Action** column, use the **Drop** button to **unbind the license** from the current host.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FsyC3fu1YkiQPOMVTFU8c%2FdropBtn.png?alt=media&#x26;token=f447b2d1-f683-487e-85eb-4409f3546986" alt=""><figcaption><p>Resetting the license on the host</p></figcaption></figure>

***

### Potential Issues

#### Registration Issues

If you encounter issues during registration, check for internet access to the MikoPBX server. Ensure connectivity to **lic.miko.ru** and **lic.mikopbx.com** over port 443 (HTTPS). Verify firewall settings and network permissions.

#### Strikethrough Key Icon

MikoPBX periodically connects to licensing servers to verify installed modules. If a module license becomes unavailable, the module will be disabled, and a strikethrough key icon will appear next to its name.
