> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pgrust.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pgrust Docs - Rust PostgreSQL 18.3 Compatible Server

> Pgrust documentation hub. Get started with the drop-in Postgres-compatible Rust server: quickstart, Docker setup, configuration, and architecture guides.

Pgrust is a complete, from-scratch Rust rewrite of PostgreSQL 18.3 — 100% wire-compatible with the PostgreSQL protocol, so you can point any existing Postgres client or driver at it without changing a line of application code. Whether you're running analytical queries, high-throughput OLTP, or a mixed workload, Pgrust gives you measurably faster performance: 18.5% faster than ClickHouse on ClickBench analytics and 30% higher read-only OLTP throughput than stock PostgreSQL 18.3. It ships as a drop-in Docker image so you can try it in minutes.

## Get Started

<CardGroup cols={2}>
  <Card title="Introduction" icon="book-open" href="/introduction">
    Learn what Pgrust is, how it differs from PostgreSQL, and when you should use it.
  </Card>

  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Run Pgrust locally in under five minutes and fire your first queries.
  </Card>

  <Card title="Docker" icon="docker" href="/docker">
    Pull the drop-in Docker image and configure it just like the official Postgres image.
  </Card>

  <Card title="Columnar Storage" icon="database" href="/concepts/columnar-storage">
    Explore pgrcolumnar, the built-in columnar engine that powers Pgrust's analytics performance.
  </Card>
</CardGroup>

## Try It Now

The fastest way to get Pgrust running is with a single Docker command. The image is a drop-in replacement for the official `postgres` image — the same environment variables, the same port, the same wire protocol.

```bash theme={null}
docker run --rm -p 5432:5432 -e POSTGRES_PASSWORD=password malisper/pgrust:v0.2
```

Once the container is up, connect with any Postgres client:

```bash theme={null}
psql -h localhost -U postgres
```

You can also explore Pgrust interactively in your browser at [pgrust.com](https://pgrust.com) — no installation required.

## Guides

<CardGroup cols={2}>
  <Card title="Migrating from Postgres" icon="arrow-right-arrow-left" href="/guides/migrating-from-postgres">
    Move an existing PostgreSQL application to Pgrust with minimal friction.
  </Card>

  <Card title="Analytics Workloads" icon="chart-bar" href="/guides/analytics-workloads">
    Configure pgrcolumnar and tune Pgrust for analytical and mixed workloads.
  </Card>

  <Card title="Configuration" icon="sliders" href="/guides/configuration">
    Understand the full set of configuration options available in Pgrust.
  </Card>

  <Card title="Built-in Extensions" icon="puzzle-piece" href="/guides/built-in-extensions">
    See which extensions ship bundled with Pgrust and how to enable them.
  </Card>
</CardGroup>

<Note>
  Pgrust is currently at **v0.2** and is not yet production-ready. The team is actively prioritizing testing and reliability. We recommend using Pgrust for evaluation, development, and benchmarking while production hardening is underway.
</Note>
