Getting Started

Rendez-vous sur la console et créez votre compte. Trois options s'offrent à vous :

Un projet = une base PostgreSQL complète avec branching, monitoring, scale to zero et backup intégrés. Depuis le dashboard, cliquez sur New Project et choisissez votre cloud et région.

À la création, Lampion provisionne automatiquement :

{
  "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
}

Copiez la connection string depuis le dashboard et utilisez-la avec votre outil préféré. Le TLS (Transport Layer Security) est obligatoire — vos données sont chiffrées en transit.

$ 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=>

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)

import psycopg2

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

Deux façons d'interagir avec votre base : la console web (SQL Editor) ou directement via 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

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

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

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

Chaque projet dispose d'un dashboard de monitoring temps réel accessible depuis la console.

Lampion offre deux mécanismes de sauvegarde complémentaires.

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

POST /v1/projects/{id}/backups/{bid}/restore
→ Crée une branche à ce LSN exact

GET /v1/projects/{id}/endpoints/{eid}/dump
→ Télécharge un fichier .sql

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

Lampion est conçu pour le travail en équipe. Invitez des collègues et attribuez des rôles granulaires.

Tout ce que vous faites dans la console est faisable via l'API REST. Créez une clé dans Settings > API Keys.

# Chaque requête nécessite un Bearer token
curl -H "Authorization: Bearer lmp_live_xxx" \
  https://api-test.lampion.cloud/v1/projects

Vous maîtrisez les bases. Voici les fonctionnalités avancées pour tirer le maximum de Lampion.