KoboToolbox

KoboToolbox est une suite open source de collecte de données sur le terrain. Les équipes conçoivent des formulaires, collectent des réponses en ligne et hors ligne sur des appareils mobiles, puis gèrent et exportent les jeux de données obtenus. Elle est largement utilisée dans le travail humanitaire et de développement.

KoboToolbox est distribué sous licence AGPL-3.0. Gratuit — non facturé.

Ce qui est installé

KPI : l’application web KoboToolbox, où vous créez les formulaires, gérez les projets et consultez et exportez les données.
KoboCAT : le service qui reçoit les soumissions de formulaires.
Un petit proxy qui sert l’adresse kc. de KoboToolbox.
Enketo : affiche vos formulaires sous forme de formulaires web, pour qu’ils puissent être remplis depuis un navigateur.
PostgreSQL (avec PostGIS) : la base de données des formulaires, des projets et des comptes.
MongoDB : stocke les soumissions.
Redis : deux instances, pour les tâches en arrière-plan et les sessions.

Tous ces éléments sont utilisés uniquement par cette installation.

Adresses web

Avec un domaine, KoboToolbox utilise trois adresses web, et a besoin des trois :

l’adresse principale, comme lakeside-kobo.scolah.com, pour KoboToolbox lui-même ;
kc. devant celle-ci, l’adresse du serveur que vous indiquez à KoboCollect sur les téléphones et tablettes ;
enketo. devant celle-ci, pour les formulaires web Enketo.

Un Sous-domaine Scolah crée les trois pour vous. Avec votre propre domaine, saisissez les trois noms d’hôte lors de son ajout, en conservant les préfixes kc. et enketo. proposés par le formulaire : KoboToolbox déduit les deux autres adresses de l’adresse principale, un autre nom ne serait donc pas utilisé. L’ajout ou la modification d’un domaine redémarre KoboToolbox pour qu’il prenne en compte les nouvelles adresses.

Vous pouvez aussi accéder à KoboToolbox via l’adresse IP du serveur et le port de l’installation. Cela suffit pour se connecter, gérer les comptes et créer des formulaires, mais les formulaires web et KoboCollect ne fonctionnent qu’une fois que l’installation a un domaine.

Avant l’installation

Processeur : les images KoboToolbox sont construites uniquement pour les processeurs x86-64 (amd64). La vérification Adéquation du serveur de l’assistant vous avertit si votre serveur a une autre architecture.

Deployment size (taille de déploiement) : définit combien de requêtes KoboToolbox traite en même temps et combien de mémoire chaque service peut utiliser. Adéquation du serveur vous indique si votre serveur est assez puissant.

Taille	KoboToolbox et KoboCAT	Bases de données	Limite de mémoire, tous services
`small`	2 workers chacun	caches plus petits	environ 5 Gio
`medium` (par défaut)	4 workers chacun	caches plus grands	environ 10 Gio

Utilisez medium pour un vrai travail de collecte de données. Vous pouvez changer de taille plus tard avec Redimensionner ; les services redémarrent avec les nouvelles limites.

Le premier démarrage met en place plusieurs bases de données et peut être long. La plateforme attend jusqu’à 25 minutes que chaque service soit opérationnel avant de signaler un problème.

Options

Champ	Rôle
Superuser username (nom d’utilisateur du superutilisateur)	Le nom d’utilisateur de l’administrateur KoboToolbox créé au premier démarrage. Par défaut `super_admin`.
Deployment size	`small` ou `medium`, comme ci-dessus.

Sous Secrets :

Champ	Rôle
Enketo encryption key (clé de chiffrement Enketo)	Facultatif. La clé qu’Enketo utilise pour chiffrer les soumissions de formulaires. Cliquez sur Générer pour obtenir une valeur aléatoire robuste. Si vous la laissez vide, l’installation utilise à la place sa propre clé secrète générée. Elle est scellée et n’est plus jamais affichée.

Avancé contient l’option d’utiliser des serveurs PostgreSQL, MongoDB ou Redis que vous exploitez déjà à la place de ceux fournis. Voir services externes.

Les adresses web, et le fait qu’elles utilisent HTTPS ou non, proviennent du domaine de l’installation : il n’y a donc rien à définir pour elles ici. Le contact d’assistance d’Enketo est l’adresse e-mail de l’administrateur de l’organisation qui a créé l’installation.

Première connexion

Au premier démarrage, KoboToolbox crée un compte administrateur (superutilisateur) :

Nom d’utilisateur : la valeur saisie dans Superuser username (super_admin sauf si vous l’avez modifiée).
Mot de passe : généré par la plateforme.

Lorsque vous cliquez sur Créer, le portail affiche le mot de passe une seule fois, sous Identifiants de première connexion, avec le libellé Mot de passe superutilisateur Kobo. Copiez-le avant de quitter la page : il ne pourra plus être affiché.

Ouvrez l’adresse principale de l’installation et connectez-vous avec ce nom d’utilisateur et ce mot de passe. Lorsqu’un formulaire nécessite un utilisateur connecté, Enketo affiche sa propre page de connexion : utilisez le même nom d’utilisateur et le même mot de passe KoboToolbox.

Les mots de passe de la base de données, de MongoDB et de Redis, ainsi que les autres clés internes, sont eux aussi générés par la plateforme et scellés. Vous n’avez jamais à les saisir.

Connexions

KoboToolbox peut fournir à une autre installation du même serveur :

KoboToolbox form data (read-only) (données de formulaires KoboToolbox, en lecture seule) : un accès en lecture seule aux bases de données PostgreSQL des formulaires et des projets. Les comptes utilisateurs, les sessions et les jetons de connexion sont exclus.
KoboToolbox submissions (read-only) (soumissions KoboToolbox, en lecture seule) : un accès en lecture seule aux soumissions stockées dans MongoDB.

Metabase peut utiliser l’une ou l’autre comme Analytics data source (source de données analytiques), pour créer des tableaux de bord sur les données de vos enquêtes.

KoboToolbox n’utilise rien provenant d’autres installations.

Voir connexions.

En savoir plus

Documentation de KoboToolbox