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) $ pip install lampion-cli # 2 · ouvrir une session — SSO Google, GitHub ou email $ export LAMPION_TOKEN=lmp_live_… 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 my-app --region fr-par-1
{
"id": "abc123",
"name": "my-app",
"region": "fr-par-1",
"endpoint_id": "ep-morning-frost-84721",
"host": "db.lampion.cloud",
"port": 5432,
"connection_string": "postgresql://cloud_admin:••••
@db.lampion.cloud:5432/ep-morning-frost-84721.postgres?sslmode=require"
} Copiez la connection string depuis la console ou la réponse ci-dessus, puis connectez-vous sur db.lampion.cloud:5432 ; le nom de base encode votre endpoint (ep-xxxx.postgres), c’est ainsi que le proxy vous route. Le TLS est obligatoire — vos données sont chiffrées en transit.
# connexion directe $ psql "postgresql://cloud_admin:••••@db.lampion.cloud:5432/ep-morning-frost-84721.postgres?sslmode=require" psql (17.4) — SSL connection (protocol: TLSv1.3) postgres=>
# 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 postgres=> CREATE TABLE users ( id SERIAL PRIMARY KEY, email TEXT UNIQUE, created_at TIMESTAMPTZ DEFAULT now() ); CREATE TABLE postgres=> INSERT INTO users (email) VALUES ('[email protected]'); INSERT 0 1 postgres=> 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 abc123 staging --parent abc123 → branch staging · db.lampion.cloud:5432/ep-staging.postgres
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 abc123 main before-migration → bk-42 · lsn 0/15A2C08 # restaurer vers une nouvelle branch $ lampion backups restore abc123 bk-42 --name restored-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 abc123 ep-abc -o backup.sql # exporter une seule table $ lampion dump abc123 ep-abc --table users -o 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.