​
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
  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.
Use the --api_endpoint flag when calling the bq CLI or configure it in your client library.
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:
const bigquery = new BigQuery({
  apiEndpoint: 'https://myteam.proxy.isofold.com'
});
Update your connection URL to point to the Isofold proxy.
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.
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).
postgres://user:pass@myteam.proxy.isofold.com:5432/dbname

​
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: 
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.