Hex Setup Guide Lite
Follow our setup guide to connect Hex to Fivetran.
Prerequisites
To connect Hex to Fivetran, you need:
- a Hex account with Admin access
- your Hex subdomain
- a Workspace token
- Find your subdomain in your Hex URL if you are a single-tenant app user. For example, if your URL looks like
atreides.hex.tech, then your subdomain isatreides.hex.tech. By default, the subdomain isapp.hex.techfor the other users. - To find your subdomain or create a workspace token, contact Hex support.
Setup instructions
In the connection setup form, enter your chosen Destination schema name.
Enter your Hex Subdomain.
Enter your Hex Workspace token.
(Hybrid Deployment only) If your destination is configured for Hybrid Deployment, the Hybrid Deployment Agent associated with your destination is pre-selected for the connection. To assign a different agent, click Replace agent, select the agent you want to use, and click Use Agent.
(Context Layer only) Set the Sync Context for your Context Layer toggle to ON. Then, address the following fields:
- Semantic Model Type: The semantic specification used by the models in your semantic model repository (for example, dbt MetricFlow).
- Hex Guides Repository URL (Optional): The SSH URL of the GitHub repository containing your Hex Guides.
- Hex Guides Repository Path (Optional): The path to the subdirectory containing your Hex Guides, relative to the repository root.
- Hex Guides SSH Deploy Key: Copy this generated SSH public key and add it as a read-only deploy key to your Hex Guides repository.
- Semantic Model Repository URL (Optional): The SSH URL of the GitHub repository containing your semantic models.
- Semantic Model Repository Path (Optional): The path to the subdirectory containing your semantic models, relative to the repository root.
- Semantic Model SSH Deploy Key: Copy this generated SSH public key. Next, follow GitHub's Deploy key setup instructions to add it to your semantic model repository. Paste the public key into the Key field and leave Allow write access unselected.
Click Save & Test. Fivetran will take it from here and sync your data from your Hex account.