Installez la CLI, ouvrez une session, créez un projet PostgreSQL sur fr-par-1 (Scaleway, Paris). Tout ce que vous voyez ci-dessous fonctionne aussi depuis la console web et l’API REST.
Sans carte bancaire · Région par défaut fr-par-1 (Scaleway, Paris) · PostgreSQL 17.4
La CLI Lampion pilote toute la plateforme depuis votre terminal. À la première session, votre organisation personnelle est créée et vous en devenez owner.
# 1 · installer la CLI (Homebrew) $ brew install lampion/tap/lampion # 2 · ouvrir une session — SSO Google, GitHub ou email $ lampion auth login session ouverte · organisation perso créée · rôle owner
Trois façons de s’inscrire
Vous démarrez sur le plan Free (3 projets, 3 branches par projet), sans carte bancaire.
Un projet = une base PostgreSQL complète : branching, monitoring, scale to zero et backups intégrés. La région par défaut est fr-par-1, hébergée par Scaleway à Paris.
Clouds & régions
À la création, Lampion provisionne automatiquement
# créer un projet dans la région fr-par-1 $ lampion projects create --name my-app --region fr-par-1
{
"id": "abc123",
"name": "my-app",
"region": "fr-par-1",
"endpoint": "ep-morning-frost-84721.fr-par-1.lampion.cloud",
"connection_string": "postgresql://cloud_admin:••••
@ep-morning-frost-84721.fr-par-1.lampion.cloud/neondb?sslmode=require"
} Copiez la connection string depuis la console ou la réponse ci-dessus, puis utilisez l’endpoint *.fr-par-1.lampion.cloud avec votre outil préféré. Le TLS est obligatoire — vos données sont chiffrées en transit.
# connexion directe $ psql "postgresql://cloud_admin:••••@ep-morning-frost-84721.fr-par-1.lampion.cloud/neondb?sslmode=require" psql (17.4) — SSL connection (protocol: TLSv1.3) neondb=>
# via la variable DATABASE_URL import pg from 'pg' const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL, ssl: { rejectUnauthorized: true }, }) const { rows } = await pool.query('SELECT version()')
# via la variable DATABASE_URL import os, psycopg with psycopg.connect(os.environ["DATABASE_URL"]) as conn: with conn.cursor() as cur: cur.execute("SELECT version()") print(cur.fetchone())
Connection pooling — Lampion intègre un pooler en mode transaction. Le proxy TCP gère le multiplexage et le wake-on-connect de manière transparente.
Deux façons d’interagir avec votre base : le SQL Editor de la console web, ou directement via psql et votre client applicatif.
SQL Editor (console web)
# créer une table, insérer, lire neondb=> CREATE TABLE users ( id SERIAL PRIMARY KEY, email TEXT UNIQUE, created_at TIMESTAMPTZ DEFAULT now() ); CREATE TABLE neondb=> INSERT INTO users (email) VALUES ('[email protected]'); INSERT 0 1 neondb=> SELECT * FROM users; id | email | created_at ----+-------------------+---------------------------- 1 | [email protected] | 2026-08-04 10:23:45.123+00
Scale to zero — après quelques minutes d’inactivité, le compute est suspendu. La première connexion suivante le réveille automatiquement, sans action de votre part.
Le branching est la killer feature de Lampion. Comme git branch, mais pour vos données : chaque branch est un fork CoW (Copy-on-Write) instantané qui partage les pages non modifiées avec sa branch parente.
Cas d’usage
# fork CoW instantané depuis main $ lampion branches create --from main --name staging → branch staging · endpoint ep-staging.fr-par-1.lampion.cloud
Comment ça marche
Chaque projet dispose d’un dashboard de monitoring accessible depuis la console, sans instrumentation à installer.
Deux mécanismes complémentaires : les snapshots PITR (Point-In-Time Recovery) au LSN près, et l’export pg_dump au format SQL standard.
Snapshots (PITR)
Capturez l’état exact de votre base à un instant T via le LSN du pageserver, puis restaurez vers une nouvelle branch. Vos données de production ne sont jamais touchées.
# capturer un snapshot au LSN courant $ lampion backups create --branch main --name before-migration → bk-42 · lsn 0/15A2C08 # restaurer vers une nouvelle branch $ lampion backups restore bk-42 → branch restored-bk-42
pg_dump
Exportez votre base au format SQL standard : migration vers un autre provider, archivage ou debugging. Filtrage par table possible.
# exporter toute la base $ lampion dump --endpoint ep-abc > backup.sql # exporter une seule table $ lampion dump --endpoint ep-abc --table users > users.sql
Lampion est conçu pour le travail en équipe. Invitez des collègues et attribuez des rôles RBAC (Role-Based Access Control) granulaires.
| Rôle | Permissions | Cas d’usage |
|---|---|---|
| owner | Tout : création, suppression, invitations, webhooks, audit. | Admin de l’équipe |
| developer | Créer/modifier projets, branches, requêtes, API keys. | Développeur au quotidien |
| viewer | Lecture seule (GET uniquement). | Stakeholder, QA, monitoring |
| analyst | Lecture seule, branches anonymisées, connection string dédiée (données masquées). | Data analyst, prestataire sans PII |
Tout ce que vous faites dans la console est faisable via l’API REST. Créez une API key dans Settings › API Keys, puis authentifiez chaque requête avec un Bearer token.
# chaque requête nécessite un Bearer token $ curl -H "Authorization: Bearer lmp_live_…" \ https://api.lampion.cloud/v1/projects
Format d’une API key
Référence complète — 40+ endpoints couvrant projets, branches, computes, SQL, métriques et webhooks dans la documentation API.
Vous maîtrisez les bases. Voici de quoi tirer le maximum de Lampion.
Chaque sujet est détaillé dans les guides et la référence API.