wiki/Catalogue-Self-Hosted/apps/app-liwan.md

---

title: Liwan created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, web-analytics, typescript, svelte] confidence: medium contested: false sources: [https://selfh.st/apps/?tag=web-analytics]

Liwan 🌐

Analytics web moderne en TypeScript (SvelteKit) avec un focus sur la simplicité, l'auto-hébergement facile et le respect de la vie privée des visiteurs.

Métadonnée	Valeur
Site web	https://liwan.dev
GitHub	https://github.com/liwancumik/liwan
License	AGPL-3.0
Langage	TypeScript (SvelteKit)
Étoiles	12
Dernière MAJ	2024
Catégorie	cat-web-analytics

Description

Liwan est un outil d'analytics web « privacy-first » construit sur SvelteKit, le meta-framework Svelte moderne. Il vise la même cible que Plausible ou Umami : un script de tracking léger, un dashboard clair, et zéro cookie.

L'UI est en single-page, rapide à charger, et propose les KPIs classiques : visiteurs uniques, pages vues, durée de session, sources de trafic, appareils, pays. Le système d'événements custom permet de tracker des actions précises (clics, soumissions de formulaire).

Le déploiement est simple : un binaire Node + SQLite, parfait pour un home lab ou un petit VPS. L'AGPL peut rebuter pour un usage commercial, mais en self-host personnel c'est sans impact.

Installation

Option 1 : Docker Compose (recommandé)

version: '3.8'
services:
  liwan:
    image: ghcr.io/liwancumik/liwan:latest
    container_name: liwan
    ports:
      - "8091:3000"
    environment:
      - LIWAN_SECRET=***      - DATABASE_URL=file:./data/liwan.db
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Option 2 : Installation manuelle

git clone https://github.com/liwancumik/liwan.git
cd liwan
npm install
npm run build
node build/index.js

Configuration

• LIWAN_SECRET : clé pour signer les sessions.
• Configurer les sites depuis l'UI.
• Ajouter le script JS sur chaque site à tracker.

Alternatives

Open Source

• app-plausible — référence
• app-umami — équivalent Node populaire
• app-matomo — PHP complet
• app-medama — Go
• app-ackee — Node minimal

Propriétaires

• Google Analytics
• Fathom Analytics
• Simple Analytics

Sécurité

• HTTPS obligatoire.
• LIWAN_SECRET fort.
• Sauvegardes SQLite.
• Mises à jour Node/SvelteKit pour les CVE.

Ressources

• Dépôt GitHub
• selfh.st listing

Pages Liées

• cat-web-analytics
• recettes-docker-compose
• securisation-home-lab