Comment auto-héberger PostHog sur un VPS (Guide complet)

PostHog est une plateforme d’analyse puissante conçue pour les développeurs qui souhaitent auto-héberger leurs applications tout en gardant le contrôle sur leurs données. Ce guide vous conduira à travers les étapes nécessaires pour installer PostHog sur un serveur privé virtuel (VPS). Nous aborderons tout, depuis le choix d’un fournisseur jusqu’à l’exécution de l’application PostHog à l’aide de Docker.

Choisir votre fournisseur de VPS

Avant de plonger dans l’installation, vous devez choisir un fournisseur de VPS. Voici quelques options populaires qui s’adressent à la fois aux développeurs et aux amateurs de homelab :

Pour une comparaison complète des VPS, visitez notre comparaison complète des VPS.

Prérequis

1. Configuration du VPS : Assurez-vous que votre VPS fonctionne sous Ubuntu 20.04 ou une version ultérieure.
2. Domaine : Il est recommandé d’avoir un nom de domaine pour un accès facile à votre instance PostHog.
3. Docker et Docker Compose : Assurez-vous que Docker et Docker Compose sont installés sur votre VPS.

Pour installer Docker et Docker Compose, utilisez les commandes suivantes :

sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install -y docker-ce
sudo apt install -y docker-compose

Installer PostHog

Maintenant que votre environnement est configuré, vous êtes prêt à installer PostHog :

1. Cloner le dépôt

Ouvrez votre terminal et exécutez la commande suivante pour cloner le dépôt de PostHog :

git clone https://github.com/PostHog/posthog.git
cd posthog

2. Créer un fichier .env

Créez un fichier .env à la racine du répertoire cloné pour configurer votre environnement PostHog. Voici un exemple de base :

# Configuration de PostHog
POSTHOG_INSTANCE_ID=your_instance_id
POSTHOG_SECRET_KEY=your_secret_key
# Ajustez les paramètres de Redis et PostgreSQL selon vos besoins

3. Configurer Docker Compose

Ensuite, créez un fichier docker-compose.yml. Voici une configuration d’exemple :

version: '3.8'
services:
  web:
    image: posthog/posthog
    env_file: .env
    ports:
      - "8000:8000"
    depends_on:
      - redis
      - postgres
      
  redis:
    image: redis:6.0
    ports:
      - "6379:6379"

  postgres:
    image: postgres:13
    environment:
      POSTGRES_DB: posthog
      POSTGRES_USER: posthog
      POSTGRES_PASSWORD: your_postgres_password
    ports:
      - "5432:5432"

networks:
  default:
    driver: bridge

4. Démarrer les services

Maintenant, démarrez votre instance PostHog en utilisant Docker Compose :

docker-compose up -d

Cette commande téléchargera les images nécessaires et démarrera les services en mode détaché.

5. Accéder à PostHog

Ouvrez votre navigateur web et allez sur http://your-domain-or-ip:8000. Vous devriez voir l’interface de PostHog où vous pouvez commencer à suivre vos données.

Configurer PostHog

Une fois PostHog en cours d’exécution, vous voudrez peut-être effectuer des configurations initiales :

1. Authentification des utilisateurs : Créez un compte utilisateur et gérez les droits d’accès.
2. Intégrer avec vos applications : Utilisez la bibliothèque JavaScript de PostHog pour ajouter le suivi à vos applications.
3. Gestion des données : Familiarisez-vous avec le tableau de bord pour gérer les événements et les propriétés.

FAQ

Puis-je exécuter PostHog sur un VPS bas de gamme ?

Absolument, PostHog peut fonctionner sur un VPS bas de gamme, mais les performances peuvent varier en fonction du nombre d’événements suivis et du nombre d’utilisateurs concurrents. Si vous débutez, envisagez d’utiliser des fournisseurs comme Hetzner Cloud ou Contabo, qui proposent des plans abordables avec suffisamment de ressources pour de petites à moyennes installations.

Comment migrer PostHog vers un autre VPS ?

Pour migrer PostHog vers un autre VPS, vous devez sauvegarder votre base de données et vos fichiers de configuration. Exportez votre base de données PostgreSQL à l’aide de pg_dump, transférez-la vers le nouveau serveur, puis restaurez-la avec psql. N’oubliez pas de déplacer également votre fichier .env et votre fichier docker-compose.yml vers le nouvel environnement.

Est-ce que PostHog est sécurisé à auto-héberger ?

L’auto-hébergement de PostHog peut être sécurisé si vous suivez les meilleures pratiques telles que l’utilisation de HTTPS, la configuration des pare-feu et la mise à jour régulière de votre logiciel. Assurez-vous de sécuriser correctement votre base de données PostgreSQL et votre instance Redis, et envisagez d’utiliser un service comme Let’s Encrypt pour les certificats SSL afin d’assurer des connexions chiffrées.

Conclusion

L’auto-hébergement de PostHog sur un VPS vous donne un contrôle total sur vos données analytiques et peut vous faire économiser de l’argent à long terme. En suivant ce guide, vous pouvez rapidement configurer et commencer à utiliser PostHog pour vos applications. Si vous rencontrez des problèmes, la communauté r/selfhosted et le dépôt awesome-selfhosted sont de grandes ressources pour le dépannage et la recherche d’outils supplémentaires. Bon auto-hébergement !