Version de développement

Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.

Exploitation

Installer une application

Télécharger une application avec bench get-app, choisir la bonne branche et l'installer sur un site Dokos auto-hébergé.

Installer une application

L'écosystème Dokos compte plusieurs applications (appelées modules, plugins ou add-ons dans d'autres logiciels). Vous pouvez les installer sur votre site si elles sont compatibles avec votre version de Dokos et avec les applications déjà installées.

Cette page concerne une installation auto-hébergée. Sur Dokos Cloud, demandez l'installation d'une application au support.

La liste des applications et leur compatibilité sont sur la page Catalogue des applications. En cas de doute, posez la question sur le forum. Vous pouvez aussi ouvrir un ticket sur la page GitLab ou GitHub de l'application : il faut un compte sur cette plateforme.

Prérequis

Un bench Dokos installé (voir Installation).
Une sauvegarde récente du site.

Choisir la branche

Cette documentation décrit la version en développement. Pour les applications maintenues par Dokos, cette version correspond à la branche develop, compatible avec la branche develop de Dodock et de Dokos. Pour un site en production, utilisez plutôt la branche v5 (voir la documentation v5).

Sans option --branch, bench get-app récupère la branche par défaut du dépôt. Pour les applications Dokos, c'est develop : la future version majeure, destinée aux développeurs.

Télécharger une application

Placez-vous dans le dossier du bench, puis lancez :

bench get-app --branch develop https://gitlab.com/dokos/bookings.git

L'application est clonée dans apps/, ses dépendances Python et JavaScript sont installées et ses fichiers statiques sont construits. --skip-assets évite cette construction.

Installer l'application sur un site

Une application téléchargée n'est active sur aucun site. Installez-la sur chaque site concerné :

bench --site <mon-site> install-app bookings

Lancez ensuite bench --site <mon-site> migrate, puis redémarrez les services (bench restart en production).

Commandes pour les applications Dokos

Application	Commande
Dokos	`bench get-app --branch develop https://gitlab.com/dokos/dokos.git`
Payments	`bench get-app --branch develop https://gitlab.com/dokos/payments.git`
Webshop	`bench get-app --branch develop https://gitlab.com/dokos/webshop.git`
HRMS	`bench get-app --branch develop https://gitlab.com/dokos/hrms.git`
Bookings	`bench get-app --branch develop https://gitlab.com/dokos/bookings.git`
Construction	`bench get-app --branch develop https://gitlab.com/dokos/construction.git`
WooCommerce	`bench get-app --branch develop https://gitlab.com/dokos/dokos-woocommerce.git`
Hiboutik	`bench get-app --branch develop https://gitlab.com/dokos/hiboutik.git`
eTransactions	`bench get-app --branch develop https://gitlab.com/dokos/etransactions.git`

L'application OCR n'a pas de branche v5. En v5, eTransactions reprend la lecture des factures PDF.

Commandes pour les applications de l'écosystème Frappe

Ces applications suivent les branches de Frappe Technologies. Vérifiez leur compatibilité avec Dodock avant de les installer.

Application	Commande
Insights	`bench get-app --branch version-3 https://github.com/frappe/insights.git`
CRM	`bench get-app --branch main https://github.com/frappe/crm.git`
Helpdesk	`bench get-app --branch main https://github.com/frappe/helpdesk.git`
LMS	`bench get-app --branch main https://github.com/frappe/lms.git`
Builder	`bench get-app --branch master https://github.com/frappe/builder.git`
Raven	`bench get-app --branch main https://github.com/The-Commit-Company/raven.git`