---
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é)

```yaml
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

```bash
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](https://github.com/liwancumik/liwan)
- [selfh.st listing](https://selfh.st/apps/?tag=web-analytics)

## Pages Liées
- [[cat-web-analytics]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]
