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

# Self-Hosted Setup

> Run Isofold in your own environment for full control and compliance.

## Self-host Isofold

Prefer to run Isofold yourself? You can deploy it in your own cloud, edge region, or local environment. This gives you complete control over performance, logging, and compliance boundaries.

## BigQuery via GCP Marketplace

Isofold offers a GCP Marketplace image for BigQuery workloads. This is the fastest way to run Isofold within your own GCP project.

<CardGroup cols={1}>
  <Card title="Launch on GCP" icon="google" href="https://console.cloud.google.com/marketplace/details/isofold-public/isofold-proxy">
    Deploy Isofold directly into your GCP project with IAM and VPC controls.
  </Card>
</CardGroup>

### After deployment

Once deployed, copy the external IP or internal load balancer address and point your BigQuery client to it:

```bash theme={null}
bq query \
  --project_id=myproject \
  --use_legacy_sql=false \
  --api_endpoint=http://<your-isofold-ip> \
  'SELECT * FROM dataset.table'
```

### Security tips

* Use a **private VPC** connection to BigQuery
* Restrict access to the proxy via IAM or firewall rules
* Enable logging or verification mode for auditability

***

## Manual deployment (Snowflake, Aurora, or custom)

For Snowflake, Aurora, or other engines, you can deploy Isofold using Docker or Fly.io.

### Option A — Docker

```bash theme={null}
docker run -p 8080:8080 \
  -e BACKEND_TYPE=snowflake \
  -e BACKEND_HOST=snowflake.mycompany.com \
  -e ISOFOLD_VERIFY_MODE=true \
  isofold/proxy:latest
```

Route traffic through `localhost:8080` or your cloud IP.

### Option B — Fly.io

1. Install the Fly CLI
2. Run `fly launch` and configure your environment
3. Deploy to a region close to your warehouse
4. Use the Fly hostname as your proxy URL

<Note icon="lightbulb">
  We recommend Fly.io for latency-sensitive, multiregion deployments.
</Note>

***

## Configuration Reference

| Variable              | Description                                 |
| --------------------- | ------------------------------------------- |
| `BACKEND_TYPE`        | `bigquery` \| `snowflake` \| `aurora`       |
| `BACKEND_HOST`        | Hostname of your target warehouse           |
| `ISOFOLD_VERIFY_MODE` | Runs original + optimized queries when true |

***

Need help? [Contact support](mailto:support@isofold.com) or explore the [architecture overview](/architecture/overview).