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

# Counter 🔢
> Compteur de visites ultra-minimaliste en TypeScript, conçu pour afficher un simple « 12 345 visiteurs » sur une page, sans dashboard, sans cookie.

| Métadonnée | Valeur |
| :--- | :--- |
| **Site web** | https://counter.dev |
| **GitHub** | https://github.com/ihucos/counter.dev |
| **License** | MIT |
| **Langage** | TypeScript (Next.js) |
| **Étoiles** | 2 |
| **Dernière MAJ** | 2023 |
| **Catégorie** | [[cat-web-analytics]] |

## Description

Counter fait exactement ce que son nom suggère : il compte. Pas de dashboard complexe, pas de segmentation d'audience, pas de heatmap : on intègre un petit badge HTML/JS et il affiche un compteur cumulatif de visiteurs uniques sur la page.

Inspiré de services comme `hits.sh` ou `visitorbadge.io`, Counter est né d'un fork d'un projet d'expérimentation et propose une version self-hostable pour ceux qui veulent garder le contrôle de leurs données de fréquentation. L'idéal est un site statique personnel, un portfolio, ou une landing page où on veut juste savoir qu'il y a du monde.

C'est l'antithèse de Google Analytics, et c'est précisément son intérêt.

## Installation

### Option 1 : Docker Compose (recommandé)

```yaml
version: '3.8'
services:
  counter:
    image: ghcr.io/ihucos/counter.dev:latest
    container_name: counter
    ports:
      - "8092:3000"
    environment:
      - COUNTER_DB=/data/counter.db
    volumes:
      - ./data:/data
    restart: unless-stopped
```

### Option 2 : Installation manuelle

```bash
git clone https://github.com/ihucos/counter.dev.git
cd counter.dev
npm install
npm run build
npm start
```

## Configuration

- Définir le nom de domaine autorisé via CORS.
- Créer un compteur par site/page via l'UI.
- Intégrer via `<script>` ou iframe.

## Alternatives

### Open Source
- [[app-ackee]] — Node, plus complet
- [[app-medama]] — Go
- [[app-liwan]] — TypeScript
- hits.sh — service minimal
- visitorbadge.io — service externe minimal

### Propriétaires
- Google Analytics
- HitsLink
- StatCounter

## Sécurité

- HTTPS obligatoire.
- Restreindre les origines CORS aux domaines autorisés.
- Sauvegardes SQLite régulières.
- Mises à jour Next.js pour CVE.

## Ressources
- [Dépôt GitHub](https://github.com/ihucos/counter.dev)
- [selfh.st listing](https://selfh.st/apps/?tag=web-analytics)

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