---
title: "Installation"
weight: 10
description: "Installation guide for the OfflinePropale module and the mobile PWA."
source_hash: "876d3060"
---

# Installation

## Requirements

Before installing OfflinePropale, check that the following are in place:

- Dolibarr version 18.0 or above
- PHP 7.4 or above
- The following Dolibarr modules must be enabled:
  - Third parties
  - Commercial proposals
  - Products / Services
  - Categories
  - Document management (ECM)
  - SmartAuth (for API authentication)

## Download

Go to the DoliStore to download the OfflinePropale module.

## Installing the module

1. Log in to Dolibarr as an administrator
2. Go to **Home > Setup > Modules/Applications > Deploy/install external module**
3. Select the downloaded ZIP file and confirm

![External module deployment page in Dolibarr](screenshots/deploiement-module.webp)

## Enabling the module

1. Go to **Home > Setup > Modules/Applications**
2. Search for "OfflinePropale" in the module list
3. Click the enable button (ON/OFF switch)

Database tables are created automatically on activation. A new **Pre-proposals** menu appears under **Commercial > Commercial proposals**.

![Enabling the OfflinePropale module in the Dolibarr module list](screenshots/activation-module.webp)

## Post-installation checks

Once enabled, check that:

- The **Commercial > Commercial proposals > List of pre-proposals** menu is reachable
- The setup page is reachable through the gear icon next to the module

![Pre-proposals menu under the Commercial menu in Dolibarr](screenshots/menu-predevis.webp)

## Installing the mobile application

The mobile application is a PWA (Progressive Web App). It installs straight from the browser, with no store involved.

The application URL depends on your setup:

- **Direct hosting**: `https://your-dolibarr.com/custom/offlinepropale/pwa/`
- **Through DoliProxy**: the URL supplied during provisioning (see [Setup](/offlinepropale/configuration))

### On an Android smartphone (Chrome)

1. Open the application URL in Chrome
2. An "Add to home screen" banner appears automatically
3. Tap **Install**
4. The application is added to your home screen like a native application

![PWA install banner on Android with the Install button](screenshots/installation-android.webp)

### On iPhone / iPad (Safari)

1. Open the application URL in Safari
2. Tap the share button (square with an upward arrow)
3. Select **Add to Home Screen**
4. Confirm the name and tap **Add**

![PWA installation steps on iOS through the Safari share button](screenshots/installation-ios.webp)

### On a desktop computer

1. Open the URL in Chrome, Edge or another compatible browser
2. Click the install icon in the address bar
3. Confirm the installation

## Updating

To update the module:

1. Download the new version from the DoliStore
2. Deploy the ZIP file through **Home > Setup > Modules/Applications > Deploy/install external module**
3. **Disable then re-enable** the module to apply database updates and register the new hooks and permissions

> **Warning:** Disabling and re-enabling is mandatory for database structure changes and new permissions to be taken into account.

## Uninstalling

To uninstall the module, disable it from **Home > Setup > Modules/Applications**. Data is kept in the database.