# Install, upgrade and uninstall apps

From the Apps page an administrator activates an app with its dependencies, upgrades an installed module, or removes it through a wizard that lists what will be deleted.

The Apps page is where an administrator adds features to Jaah, reapplies a module after its code changed, or removes a module that is no longer needed. It is reserved for the **Administrator** role: the Apps menu and the **Activate**, **Upgrade** and **Uninstall** buttons are hidden from everyone else, and the server refuses the operation to a non-administrator even when it is called directly.

## Before you start {#before-you-start}

- You have the **Administrator** role (the **Role** choice in the **Access Rights** tab of your user).
- Nobody else is installing, upgrading or removing a module: the system accepts one module operation at a time and refuses the next one with an error until the first has finished.
- Every module operation rebuilds the registry and blocks the interface for all users while it runs. On a busy database, plan it outside working hours.
- Uninstalling deletes the module's tables, columns, menus, views and records for good. Keep a backup, or try it on a duplicate or test database first; the wizard reminds you of it.
- On a hosted subscription the list may be limited to the apps of your plan.

## Steps {#steps}

1. Open **Apps/Apps/Main Apps**. The page opens in kanban with the **Apps** filter: one card per app, with **Activate** on the apps that are not installed, and **Module Info** with a three-dots menu on the installed ones.

![The Apps page in kanban with the Apps filter; Activate on the apps that are not installed, Module Info and a three-dots menu on the others.](https://jaah.app/web/image/6946-32d9d1be/general-settings-apps-apps_page-en.png)

2. Type the name of the app in **Search...** and press Enter. The search matches the name, the summary and the technical name. The **Installed** and **Not Installed** filters and the **Categories** panel narrow the list; **Extra** adds the technical modules to the list.

![The search narrowed the page to the Contacts app, which is already installed.](https://jaah.app/web/image/6950-356de74c/general-settings-apps-apps_search-en.png)

3. To install, click **Activate** on the card. Its dependencies are installed with it, the interface is blocked while the registry rebuilds, then it reloads, either on the first configuration step of the app or on the first menu.

4. To upgrade or uninstall an installed app, open the card menu (the three dots, **Dropdown menu**). **Module Info** opens the module form, with its description and the same buttons. **Upgrade** reapplies the views, data, access rights and translations of the module from the code on the server, upgrades every installed module that depends on it, and installs a dependency it now requires. **Uninstall…** opens the uninstall wizard.

![The card menu of an installed app, with Module Info, Upgrade and Uninstall.](https://jaah.app/web/image/6954-fab17b7c/general-settings-apps-apps_card_menu-en.png)

5. The **Uninstall module** wizard lists **Apps to Uninstall**: the app and every installed module that depends on it; tick **Show All** to see the technical modules among them. **Documents to Delete** lists the models whose records disappear with the module, with their counts. Click **Uninstall** to confirm or **Discard** to keep everything.

![The Uninstall module wizard lists the apps that would go and the documents that would be deleted. Nothing happens until Uninstall is clicked.](https://jaah.app/web/image/6956-2d5d2bd2/general-settings-apps-uninstall_wizard-en.png)

!!! warning "The wizard is the last stop"
    Once you click **Uninstall**, the modules are marked for removal and the registry is rebuilt without them. The documents listed in the wizard are deleted in that same run; only a backup brings them back.

## Result {#result}

An installed app loses the **Activate** button on its card and shows **Module Info** with the three-dots menu instead; its menu is added to the home menu and its settings tab to Settings. After an upgrade the module stays installed with its latest definition applied; your records are untouched. After an uninstall the card shows **Activate** again and everything the module created, including the documents listed by the wizard, is gone.

## FAQ {#faq}

### Why do I not see the Apps menu? {#why-do-i-not-see-the-apps-menu}

Apps is reserved for the **Administrator** role. The **Access Rights** group opens the Settings app for users and companies, but neither Apps nor General Settings. Ask an administrator to change your **Role** in the **Access Rights** tab of your user.

### Why is a module missing from the list? {#why-is-a-module-missing-from-the-list}

The **Apps** filter shows applications only: remove it, or use **Extra**, to see the technical modules. The platform also hides the modules that depend on external paid services (in-app purchases, SMS, IoT boxes) and the placeholders of apps that are not part of the platform. On a hosted subscription with a plan, only the apps of the plan are listed.

### Can I undo an uninstall? {#can-i-undo-an-uninstall}

No. The models listed under **Documents to Delete** are deleted with the module and come back only from a backup. Reinstalling the app creates its structure again, empty. Test on a copy of the database before uninstalling anything that holds data.

### Where are Update Apps List and Apply Scheduled Upgrades? {#where-are-update-apps-list-and-apply-scheduled-upgrades}

Both are entries of the Apps menu that appear in developer mode only. **Update Apps List** re-reads the modules present on the server, for example after new code was deployed; **Apply Scheduled Upgrades** runs the operations left in a scheduled state. See [Developer mode and the technical menus](developer-mode-and-technical-menus).

---

- Source: https://jaah.app/docs/general-settings/install-upgrade-and-uninstall-apps
- Updated: 2026-10-13
- Version: General settings and administration 19.0.1.0
- Verified: 2026-10-13