Start With Oliphaunt

Oliphaunt is embedded PostgreSQL for apps. Install the SDK for your app target, open a PostgreSQL root inside app-owned storage, run SQL, and select only the extensions your app ships.

This page is the shortest tutorial path. Pick one app target, prove the runtime with one query, then move into the SDK, runtime, extension, or storage page that matches the next decision.

Start In One App Target

First Query Shape

Every SDK uses ecosystem-native syntax. The application flow stays the same: choose storage, select a runtime mode, select exact extensions, open, query, and close or detach through the SDK lifecycle.

const db = await Oliphaunt.open({
  root: 'main.oliphaunt',
  engine: 'nativeDirect',
  extensions: ['vector'],
});

const rows = await db.query('select 1 as ready');
await db.close();

let db = Oliphaunt::builder()
    .root("main.oliphaunt")
    .mode(RuntimeMode::NativeDirect)
    .extension("vector")
    .open()
    .await?;

db.query("select 1 as ready").await?;
db.close().await?;

let db = try await Oliphaunt.open(
  root: .appStorage("main.oliphaunt"),
  mode: .nativeDirect,
  extensions: ["vector"]
)

try await db.query("select 1 as ready")
try await db.close()

Use the SDK page for your app target when you need platform setup, native build consequences, lifecycle hooks, extension artifacts, backup, restore, and troubleshooting.

After The First Query

Use these pages when the first runtime path works and the app needs the next production decision.