Skip to navigation
Connect

Repositories

Choose which repositories a project's sessions use, and how each one is set up
View as Markdown

A project’s sessions can only use the repositories you link to it. Link them on the project’s Repositories tab, then use Repository setup to give their sessions variables, a setup script, internet access and QA checks.

Owners, Admins and Engineers link and unlink repositories. Viewers can see the list. Only Owners and Admins change Repository setup; Engineers can inspect it.
1

Open the project's Repositories tab

In your project, choose Repositories.
2

Find the repository

Search, or filter by Private, Public or Needs attention.
Project repositories page with the All, Private, Public and Needs attention filters and a table of repositories with Access, Default branch, Used by and Status columns
A project's Repositories tab

You can link a repository only if the organization’s GitHub App can reach it and your GitHub account has write access to it. If not, the row offers Connect GitHub or Configure access. See Connect GitHub.

Set up a repository’s sessions

1

Open Repository setup

In your project, choose Settings, then Repository setup.
2

Open the repository

Choose Configure on the repository’s card.
3

Make your changes

Use the tabs in the table below.
4

Save

Save on the tab you changed: Save settings on Network, Setup script and QA checks, or Save variables on Variables. New sessions use the changes; sessions already running keep what they started with.
Repository setup sheet with the Variables, Network, Setup script, QA checks and Credentials tabs, open on Variables with two variables entered and one marked Secret
Repository setup for one repository
TabWhat it sets
VariablesEnvironment variables. Turn on Secret to hide a value; plain values are readable.
NetworkNo network, Trusted hosts (package registries and toolchain hosts), Full access (any public host) or Custom hosts.
Setup scriptCommands that run before the agent starts, such as installing dependencies. Timeout 1 to 600 seconds.
QA checksCommands that prove a change works, such as your tests. See QA checks.
CredentialsAPI credentials AOSplane adds to requests for the hosts you name. The agent never sees the values.

Good to know

  • Forks, archived and disabled repositories can’t be linked.
  • Used by shows how many of the project’s agents use a repository. Unlinking one asks you to confirm, and sessions in the project can’t use it afterwards. You can link it again later.
  • New repositories on GitHub show up within a minute or two. Choose Sync now to check right away.
  • Needs attention collects repositories that need the GitHub App or your GitHub account before you can link them.