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:
- Enter a Name.
- In Path, enter the absolute path to the local Git repository.
- 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.