Oore CI
Build and ship

Create an app

Create an Oore app from a trusted local or connected Git repository.

Create one app for the repository you want Oore to build. In Local Only, the default path uses a Git repository on the backend Mac. External Access uses a repository discovered through a connected source.

The API and command line call an app a project, as in project_id and oore pipeline validate --project.

Creating an app trusts the repository’s code to run on your runner. How Oore trusts Direct macOS runners explains why.

What you need

  • An instance owner or admin account.
  • For Local Only, an absolute path to a Git repository on the backend Mac.
  • For External Access, a connected GitHub or GitLab source with the repository visible in Oore.

Important — Repository trust

Creating or relinking an app trusts that repository’s checkout, dependencies, and commands to run with the Direct macOS runner account’s permissions. Use a repository you would run on that Mac yourself.

1. Open the app form

Open Apps, then select New app.

2. Choose the repository

In Local Only:

  1. Enter a Name.
  2. In Path, enter the absolute path to the local Git repository.
  3. Set Default branch (optional) only when Oore should not use the repository’s detected default.

Folder browsing is available only from loopback. You can always paste the absolute path.

In External Access, select Repository from the connected source, then confirm the app name and optional default branch.

3. Create the app

Select Create app. Oore links the repository as part of this action; there is no separate repository-approval step.

Verify the result

The new app opens and appears in Apps. Its page shows the linked repository and offers Set up a build under Pipelines.

Troubleshooting

The local path is rejected

Use an absolute path to a directory that is already a Git repository on the backend Mac. Local repository paths are available only in Local Only.

The connected repository is missing

Open Sources, confirm the source is active, and sync its repositories or apps. Then reopen New app.

The app action is unavailable

Only an instance owner or admin can make the repository trust decision. Ask one of them to create or relink the app.

Next step

Configure a pipeline in the UI from a template. If the repository already has an .oore.yaml, Oore offers it instead. See Move a pipeline into .oore.yaml.