Skip to main content
Connect your LookML models to Modus so its explores, views, and fields become context that Modus can reason over. Modus reads your LookML read-only from one of two sources — a Git repository or a Looker instance — and stores any credentials encrypted in AWS Secrets Manager.

​
Choose a source

1

Pick where your LookML lives

On the connection form, choose a Connection Source:
  • Git Repo — read LookML files directly from a Git repository (GitHub today; GitLab and Bitbucket are coming soon).
  • Looker Instance — read models directly from Looker via its API.

​
Set up access

Modus reads your LookML files from GitHub via a GitHub App connection.
  1. In the form, keep Git Repo selected and GitHub as the provider.
  2. Click Connect GitHub Account and authorize the Modus GitHub App with read access to the repository that holds your LookML.
  3. Select the repository and branch (defaults to main).

​
Network access

If you use the Looker Instance source and your Looker is behind a firewall, allow Modus’s egress IP addresses so it can reach it. See IP Allowlisting.

​
Connect in Modus

1

Open the LookML connection form

  1. Log into Modus.
  2. Click Integrations in the left sidebar.
  3. Find the LookML card under Semantic Layers and click Connect.
2

Choose the source and fill in the details

Select Git Repo or Looker Instance and complete the fields for that source (see Set up access above).
Modus LookML connection form
3

Test and save

  1. Click Test Connection to verify Modus can read your LookML.
  2. Click Save Connection.

​
Connection form field reference

Git Repo source Looker Instance source

​
Troubleshooting

​
Verification

Your LookML is now connected. Modus turns your explores, views, and fields into context so Modus can give accurate, semantic-layer-aware answers. Need help? Contact us at support@getmodus.com.
Modus connects read-only and requests only the minimum access needed to understand your models. Any credentials are encrypted and stored in AWS Secrets Manager — never in plaintext.