> ## 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.

# Cloud Setup

> Connect to Isofold Cloud to optimize queries without hosting anything yourself.

## Use Isofold Cloud

Isofold Cloud is the fastest way to get started—no infrastructure required. It runs in Fly.io edge regions and proxies your queries to BigQuery, Snowflake, or Aurora.

### Step 1 — Get your proxy URL

1. Sign up at [isofold.com](https://isofold.com)
2. Go to the **Dashboard**
3. Copy your team’s assigned proxy URL
   *Example*: `https://myteam.proxy.isofold.com`

### Step 2 — Configure your application or CLI

Update your client or application to point to the Isofold proxy.

<AccordionGroup>
  <Accordion icon="database" title="BigQuery">
    Use the `--api_endpoint` flag when calling the `bq` CLI or configure it in your client library.

    ```bash theme={null}
    bq query \
      --project_id=myproject \
      --use_legacy_sql=false \
      --api_endpoint=https://myteam.proxy.isofold.com \
      'SELECT * FROM analytics.users LIMIT 1000'
    ```

    Or set it in code:

    ```ts theme={null}
    const bigquery = new BigQuery({
      apiEndpoint: 'https://myteam.proxy.isofold.com'
    });
    ```
  </Accordion>

  <Accordion icon="snowflake" title="Snowflake">
    Update your connection URL to point to the Isofold proxy.

    ```txt theme={null}
    jdbc:snowflake://myteam.proxy.isofold.com/?user=...&password=...
    ```

    If you're using the Snowflake Node.js or Python client, set the host to your proxy domain.
  </Accordion>

  <Accordion icon="cloud" title="Aurora">
    Aurora clients should update their connection string to point to the Isofold proxy, typically using a hostname override or a proxy-aware connection pooler (e.g. PgBouncer).

    ```txt theme={null}
    postgres://user:pass@myteam.proxy.isofold.com:5432/dbname
    ```
  </Accordion>
</AccordionGroup>

## Step 3 — Confirm traffic is flowing

Once connected, use the Isofold dashboard or logs to:

* Monitor query traffic
* Confirm optimizations are being applied
* View query diffs or cost savings

## Optional — Enable verification mode

Isofold supports verification mode, which runs both the original and optimized query to confirm that results match exactly.

Enable it in the dashboard or by setting the environment variable:

```bash theme={null}
export ISOFOLD_VERIFY_MODE=true
```

Verification runs side-by-side queries and surfaces mismatches for debugging or audit purposes.

***

Need to host Isofold yourself? Follow the Self-hosted setup.
