Installer FreeScout : la solution helpdesk open source gratuite

FreeScout est une solution de helpdesk open source gratuite et auto-hébergée. Ce tutoriel complet vous guide pas à pas pour l’installer avec Docker sur un serveur Debian 12 (Bookworm), configurer la messagerie, le SSL, la langue française et assurer une maintenance sécurisée.

Introduction

FreeScout est une solution de helpdesk open source gratuite et auto-hébergée. Ce tutoriel complet vous guide pas à pas pour l’installer avec Docker sur un serveur Debian 12 (Bookworm), configurer la messagerie, le SSL, la langue française et assurer une maintenance sécurisée.

Vous cherchez une alternative libre et efficace à Zendesk ou Freshdesk ? FreeScout est une solution open source que vous pouvez installer sur votre propre serveur, sans frais de licence et avec un contrôle total sur vos données.
La plateforme est entièrement gratuite dans sa version de base, mais propose également des modules additionnels optionnels (chat en direct, intégration WhatsApp, Telegram ou rapports avancés) pour étendre ses fonctionnalités selon vos besoins.

Ce guide est idéal pour les freelances, PME et services support souhaitant héberger leur propre solution en France ou en Europe, tout en respectant le RGPD.

Pourquoi choisir FreeScout ?

FreeScout est un helpdesk open source écrit en PHP (Laravel) qui vous permet de centraliser vos e-mails de support, gérer plusieurs boîtes partagées, attribuer des tickets et collaborer facilement entre agents.

Ses principaux atouts

• 100 % gratuit et open source
• Agents illimités
• Interface responsive et en français
• Modules supplémentaires disponibles (live chat, WhatsApp, Telegram, etc.)
• Auto-hébergeable : données sous votre contrôle
• Compatible Docker, facile à mettre à jour

Comparatif rapide

Critère	FreeScout	Zendesk / Freshdesk
Coût	Gratuit	Payant par agent
Données	Sur votre serveur	Cloud externe
Langue FR	Oui	Oui
RGPD	Conforme (auto-hébergé)	Données hors UE possibles

Prérequis techniques

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un serveur ou VPS (idéalement situé en France : OVH, Scaleway, o2Switch) avec Debian 12 (Bookworm) installé
• Un nom de domaine (ex : support.votresite.fr)
• Un certificat SSL (Let’s Encrypt ou autre)
• Des accès SSH et privilèges root

ℹ️ Ce tutoriel est testé sur Debian 12, mais fonctionne aussi sur Ubuntu 22.04 LTS et versions ultérieures.

Installation des composants nécessaires sur Debian 12

1. Mettre à jour le système

sudo apt update && sudo apt upgrade -y

2. Installer Docker

sudo apt install ca-certificates curl gnupg lsb-release -y
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

Vérifiez que Docker fonctionne :

sudo docker run hello-world

3. Installer Docker Compose

Sur Debian 12, Docker Compose est intégré à Docker. Si besoin, installez-le manuellement :

sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

Installation de FreeScout avec Docker (tutoriel pas à pas)

1. Créez un dossier de projet

mkdir freescout && cd freescout

2. Créez le fichier docker-compose.yml

Voici un exemple complet et corrigé :

version: '3.8'

services:
  freescout:
    image: tiredofit/freescout:latest
    container_name: freescout
    restart: always
    environment:
      - DB_HOST=freescout-db
      - DB_NAME=freescout
      - DB_USER=freescout
      - DB_PASS=motdepassefort
      - SITE_URL=https://support.votresite.fr
      - ADMIN_EMAIL=admin@votresite.fr
      - ADMIN_PASS=MotDePasseAdmin
      - ENABLE_SSL_PROXY=true
      - TIMEZONE=Europe/Paris
    volumes:
      - ./data:/data
      - ./logs:/www/logs
    networks:
      - freescout-net

  freescout-db:
    image: mariadb:10.11
    container_name: freescout-db
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=MotDePasseRoot
      - MYSQL_DATABASE=freescout
      - MYSQL_USER=freescout
      - MYSQL_PASSWORD=motdepassefort
    volumes:
      - ./db:/var/lib/mysql
    networks:
      - freescout-net

networks:
  freescout-net:
    driver: bridge

3. Lancez les conteneurs

docker-compose up -d

L’installation peut prendre quelques minutes. Une fois terminée, rendez-vous sur :

https://support.votresite.fr

Connectez-vous avec l’e-mail et le mot de passe définis dans les variables ADMIN_EMAIL et ADMIN_PASS.

Configuration de FreeScout en français et intégration mail

Langue et fuseau horaire

Dans Paramètres → Général, choisissez :

• Langue : Français (FR)
• Fuseau horaire : Europe/Paris

Configuration de la messagerie

1. Allez dans Paramètres → Boîtes de réception
2. Cliquez sur Nouvelle boîte de réception
3. Renseignez les informations IMAP (réception) et SMTP (envoi)

Exemple :

• IMAP : imap.votresite.fr (port 993, SSL)
• SMTP : smtp.votresite.fr (port 465, SSL)

Cela permettra à FreeScout de convertir automatiquement vos e-mails entrants en tickets.

Ajout d’agents et permissions

Créez des utilisateurs supplémentaires via Administration → Utilisateurs et attribuez-leur des rôles (Agent, Superviseur, Admin…).

Maintenance et sécurité de FreeScout (sauvegardes, mises à jour, SSL)

• Sauvegardes : prévoyez un dump quotidien de la base MySQL et une copie du dossier /data.
• Mises à jour : docker-compose pull && docker-compose up -d.
• SSL / Proxy inverse : utilisez Nginx ou Traefik pour gérer le HTTPS.
• Modules additionnels : explorez le Marketplace de FreeScout (chat, WhatsApp, etc.).

Liens utiles

• Télécharger FreeScout
• Image Docker officielle
• Documentation Docker officielle

Tarification des modules FreeScout

La solution FreeScout est gratuite et open source dans sa version de base. Pour aller plus loin, elle propose une bibliothèque de modules additionnels payants, vendus à vie (licence unique, sans abonnement) sur le site officiel. Leurs prix varient généralement entre 5 $ et 30 $ selon la complexité du module :

• Module Chat en direct → environ 14,99 $
• Intégration WhatsApp → 19,99 $
• Automatisations avancées / rapports → 4,99 $ à 12,99 $

Ces extensions permettent d’ajouter des fonctions spécifiques sans remettre en cause la gratuité du cœur du logiciel.

Alternatives open source à FreeScout

Alternatives possibles : Zammad, osTicket, UVdesk.
FreeScout reste le plus léger et simple à maintenir, idéal pour les petites équipes.

En résumé

FreeScout est une solution d’assistance client open source puissante, simple à installer et respectueuse de la vie privée.
Avec Docker sur Debian 12, sa mise en place se fait en quelques minutes et sa maintenance est minimale.
Idéal pour les entreprises souhaitant garder le contrôle de leurs données tout en offrant un support professionnel.

• Visiter le site officiel FreeScout
• Documentation de l’image Docker

Foire aux questions (FAQ)