Getting Started

De zero a votre premiere requete en moins de 2 minutes. Ce guide vous accompagne pas a pas dans la prise en main de Lampion.

Creer un compte

Rendez-vous sur la console et creez votre compte. Trois options s'offrent a vous :

Google OAuth

Un clic, aucun mot de passe a retenir. Votre organisation personnelle est creee automatiquement.

GitHub OAuth

Ideal si votre workflow est centre sur GitHub. Meme experience, meme rapidite.

Email + mot de passe

Inscription classique. Choisissez un mot de passe robuste, c'est parti.

A l'inscription, Lampion cree automatiquement votre organisation personnelle et vous attribue le role owner. Vous etes sur le plan Free par defaut (3 projets, 3 branches par projet).

Creer un projet

Un projet = une base PostgreSQL complete avec branching, monitoring, scale to zero et backup integres. Depuis le dashboard, cliquez sur New Project.

Champs requis

name Nom de votre projet (ex: my-app)

region Region (defaut: fr-par-1, Paris)

Regions disponibles

fr-par-1 — Paris (Vitry-sur-Seine)

fr-par-2 — Paris (Saint-Ouen-l'Aumone)

nl-ams-1 — Amsterdam (Schiphol-Rijk)

A la creation, Lampion provisionne automatiquement :

Timeline

Branche principale

Compute

Instance PostgreSQL

Mot de passe

Genere & unique

Connection string

Prete a l'emploi

Reponse du serveur

{
  "id": "abc123",
  "name": "my-app",
  "region": "fr-par-1",
  "endpoint_id": "ep-abc",
  "connection_string": "postgresql://cloud_admin:YaQYfbg...@db-test.lampion.cloud:5432/ep-abc.postgres?sslmode=require",
  "pg_password": "YaQYfbg...",
  "host": "db-test.lampion.cloud",
  "port": 5432
}

Se connecter a la base

Copiez la connection string depuis le dashboard et utilisez-la avec votre outil prefere. Le TLS (Transport Layer Security) est obligatoire — vos donnees sont chiffrees en transit.

psql Client PostgreSQL natif

$ psql "postgresql://cloud_admin:YaQYfbg...@db-test.lampion.cloud:5432/ep-abc.postgres?sslmode=require"

psql (17.5) — SSL connection (protocol: TLSv1.3)
ep-abc.postgres=>

Node.js pg / node-postgres

import pg from 'pg'

const pool = new pg.Pool({
  connectionString: process.env.DATABASE_URL,
  ssl: { rejectUnauthorized: true }
})

const { rows } = await pool.query('SELECT version()')
console.log(rows[0].version)

Python psycopg2 / asyncpg

import psycopg2

conn = psycopg2.connect(os.environ["DATABASE_URL"])
with conn.cursor() as cur:
    cur.execute("SELECT version()")
    print(cur.fetchone())

Connection pooling — Lampion integre PgBouncer en mode transaction. Pour l'activer, connectez-vous via le parametre options plutot que via le nom de base. Le proxy TCP gere le multiplexage et le wake-on-connect de maniere transparente.

Executer des requetes

Deux facons d'interagir avec votre base : la console web (SQL Editor) ou directement via votre client.

Via le SQL Editor (console web)

Multi-onglets — travaillez sur plusieurs requetes en parallele

Historique — retrouvez vos 100 dernieres requetes

Explain Analyze — plan d'execution en un clic

Export CSV — telechargez les resultats

Import SQL — chargez un fichier .sql

Raccourcis — Ctrl+Enter (executer), Ctrl+S (sauvegarder)

Meta-commandes psql — \dt, \d, \l supportes

Requetes sauvegardees — organisez vos snippets

Via psql ou votre client

ep-abc.postgres=> CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  name TEXT NOT NULL,
  email TEXT UNIQUE,
  created_at TIMESTAMPTZ DEFAULT now()
);
CREATE TABLE

ep-abc.postgres=> INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com');
INSERT 0 1

ep-abc.postgres=> SELECT * FROM users;
 id | name  |       email        |         created_at
----+-------+--------------------+----------------------------
  1 | Alice | alice@example.com  | 2026-03-31 10:23:45.123+00

Scale to zero — si votre compute est suspendu (apres 5 min d'inactivite), la premiere connexion le reveille automatiquement en moins d'une seconde. Aucune action de votre part.

Creer une branche

Le branching est la killer feature de Lampion. Comme git branch, mais pour vos donnees. Chaque branche est un fork CoW (Copy-on-Write) instantane : elle partage les pages non modifiees avec la branche parente.

Cas d'usage

Tester une migration

Branchez, executez votre ALTER TABLE, validez. Pas de risque en prod.

Environnement de staging

Un fork complet de votre base de prod, en lecture/ecriture, sans copie.

Preview pour la CI/CD (Continuous Integration/Delivery)

Une branche par pull request. Automatisable via l'API.

Comment ca marche

1. Lampion capture le LSN (Log Sequence Number) actuel

2. Le pageserver cree un fork CoW a ce LSN

3. Un nouveau compute demarre sur ce fork

4. Les seed scripts s'executent automatiquement

5. Vous recevez une connection string dediee

Console ou via l'API

Creation

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -d '{"name":"staging","parent_id":"main-tid"}' \
  https://api-test.lampion.cloud/v1/projects/{id}/branches

Reponse

{
  "id": "new-tid",
  "name": "staging",
  "compute_id": "ep-new",
  "pg_port": 55436
}

Monitoring et metriques

Chaque projet dispose d'un dashboard de monitoring temps reel accessible depuis la console.

Connexions

Total, actives, idle, en attente. Visualisez en temps reel la charge reseau de votre base.

Performance

Cache hit ratio, transactions committed/rolled back, CPU et memoire du compute.

Stockage

Taille logique, physique et WAL (Write-Ahead Log). Taille par base de donnees.

Historique 24h

Graphes interactifs avec un snapshot toutes les 30 secondes. Jusqu'a 72h via l'API.

Query Analysis

Top slow queries via pg_stat_statements. Tri par temps total, temps moyen ou nombre d'appels.

Sauvegardes et restauration

Lampion offre deux mecanismes de sauvegarde complementaires.

Snapshots (PITR)

Capturez l'etat exact de votre base a un instant T via le LSN (Log Sequence Number) du pageserver. Restaurez vers une nouvelle branche en un clic — vos donnees de production ne sont jamais touchees.

POST /v1/projects/{id}/backups
{"name": "before-migration", "branch_id": "main-tid"}

POST /v1/projects/{id}/backups/{bid}/restore
→ Cree une branche a ce LSN exact

pg_dump via l'API

Exportez votre base au format SQL standard. Utile pour la migration vers un autre provider, l'archivage, ou le debugging. Filtrage par table possible.

GET /v1/projects/{id}/endpoints/{eid}/dump
→ Telecharge un fichier .sql

GET ...?table=users
→ Dump d'une seule table

Inviter son equipe

Lampion est concu pour le travail en equipe. Invitez des collegues et attribuez des roles granulaires.

ROLE	PERMISSIONS	CAS D'USAGE
`owner`	Tout (creation, suppression, invitations, webhooks, audit)	Admin de l'equipe
`developer`	Creer/modifier des projets, branches, requetes, API keys	Developpeur au quotidien
`viewer`	Lecture seule (GET uniquement)	Stakeholder, QA (Quality Assurance), monitoring

Audit log — chaque action (creation de projet, invitation, changement de role, suppression) est tracee dans le journal d'audit de votre organisation. Accessible aux owners via GET /v1/orgs/audit-log.

Utiliser l'API

Tout ce que vous faites dans la console est faisable via l'API REST. Creez une cle dans Settings > API Keys.

Authentification

# Chaque requete necessite un Bearer token
curl -H "Authorization: Bearer lmp_live_xxx" \
  https://api-test.lampion.cloud/v1/projects

Format de cle

Prefixe : lmp_live_

Scope : organisation courante

Permissions : role developer

La cle n'est affichee qu'une seule fois

Pour la reference complete de tous les endpoints, consultez la documentation API — 40+ endpoints couvrant projets, branches, computes, SQL, metriques, webhooks, et plus.

Aller plus loin

Vous maitrisez les bases. Voici les fonctionnalites avancees pour tirer le maximum de Lampion.

Database Seeding

Attachez des scripts SQL a votre projet. Ils s'executent automatiquement sur chaque nouvelle branche — donnees de test, fixtures, fonctions utilitaires.

Query Replay

Capturez les requetes d'une branche, rejouez-les sur une autre. Detectez les regressions de performance avant de merger une migration.

Read Replicas

Ajoutez des replicas en lecture seule sur une branche pour distribuer la charge de vos requetes analytiques.

Webhooks

Recevez des notifications HTTP signees (HMAC-SHA256) sur les evenements : creation, suppression, suspend/resume.

Extensions

Installez pgvector, PostGIS, pg_cron et d'autres extensions PostgreSQL en un clic depuis la console ou l'API.

Data Residency

Verifiez ou vos donnees resident physiquement : region, datacenter, provider, certifications ISO 27001 / HDS.

Pret a commencer ?

Creez votre premiere base PostgreSQL en quelques secondes.

Creer un compte Documentation API