​
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

You can self-host Isofold using Docker or deploy to your own Fly.io region.
  1. Follow the self-hosted guide
  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.

​
Connect your warehouse

Isofold works with several major data warehouses.

BigQuery

Works with bq, client libraries, and the REST API.

Snowflake

Easily integrates with Snowflake clients and JDBC/ODBC tools.

Aurora

Use a Postgres-compatible connection string.

​
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
Enable verbose logging or connect to your Isofold dashboard to confirm that queries are reaching the proxy and being rewritten.
Use the /verify endpoint or dashboard comparison view to see how your query was rewritten—and confirm result equivalence.

​
What’s next?

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

Understand the Rewrite Engine

Learn how Isofold transforms queries while preserving output.

Track Savings

View reports of total credits saved over time.

Tune Optimization Settings

Adjust rewrite strategies and cost thresholds.

Verify Query Equivalence

Ensure rewritten queries match original results.