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

# Quickstart

> Deploy Isofold and start saving on query costs in minutes.

## Set up Isofold

Isofold acts as a proxy between your app and your data warehouse. This guide walks you through connecting your application to Isofold Cloud.

### Choose your setup path

<AccordionGroup>
  <Accordion icon="cloud" title="Use Isofold Cloud (Recommended)">
    The fastest way to get started.

    1. Sign up at [isofold.com](https://isofold.com)
    2. Retrieve your team’s **proxy URL**
    3. Configure your application or warehouse client to point to the Isofold endpoint

    Example for BigQuery:

    ```
    bq query \
      --project_id=myproject \
      --use_legacy_sql=false \
      --api_endpoint=https://proxy.isofold.com \
      'SELECT * FROM analytics.users LIMIT 1000'
    ```
  </Accordion>

  <Accordion icon="server" title="Run Isofold Yourself">
    You can self-host Isofold using Docker or deploy to your own Fly.io region.

    1. Follow the [self-hosted guide](/setup/self-hosted)
    2. Point your application or client to your proxy’s IP or domain
    3. Ensure your proxy has network access to your data warehouse

    Self-hosting gives you full control over isolation and observability.
  </Accordion>
</AccordionGroup>

## Connect your warehouse

Isofold works with several major data warehouses.

<CardGroup cols={3}>
  <Card title="BigQuery" icon="database" href="/integrations/bigquery">
    Works with `bq`, client libraries, and the REST API.
  </Card>

  <Card title="Snowflake" icon="snowflake" href="/integrations/snowflake">
    Easily integrates with Snowflake clients and JDBC/ODBC tools.
  </Card>

  <Card title="Aurora" icon="cloud" href="/integrations/aurora">
    Use a Postgres-compatible connection string.
  </Card>
</CardGroup>

## Verify your integration

Once connected, Isofold will begin optimizing your queries. You can verify:

* Queries are passing through Isofold
* Optimizations are applied
* Results match exactly

<AccordionGroup>
  <Accordion icon="magnifying-glass" title="Log inspection">
    Enable verbose logging or connect to your Isofold dashboard to confirm that queries are reaching the proxy and being rewritten.
  </Accordion>

  <Accordion icon="code-compare" title="Check rewritten output">
    Use the `/verify` endpoint or dashboard comparison view to see how your query was rewritten—and confirm result equivalence.
  </Accordion>
</AccordionGroup>

## What's next?

Now that you're saving on queries, explore additional features:

<CardGroup>
  <Card title="Understand the Rewrite Engine" icon="gears" href="/architecture/rewrite-engine">
    Learn how Isofold transforms queries while preserving output.
  </Card>

  <Card title="Track Savings" icon="chart-line" href="/billing/reports">
    View reports of total credits saved over time.
  </Card>

  <Card title="Tune Optimization Settings" icon="sliders" href="/architecture/overview">
    Adjust rewrite strategies and cost thresholds.
  </Card>

  <Card title="Verify Query Equivalence" icon="shield-check" href="/api/verify">
    Ensure rewritten queries match original results.
  </Card>
</CardGroup>