​
Prerequisites

  • Administrator access to MAIster
  • A git repository reachable from the MAIster host
  • A clean default branch
  • Host credentials for cloning or fetching the repository

​
Register an existing directory

  1. Open Projects → Add project.
  2. Choose the existing-directory onboarding mode.
  3. Enter the absolute repository path.
  4. Optionally set the display name.
  5. Submit and review validation results.
When maister.yaml is absent, MAIster writes a minimal valid manifest using the resolved default branch. When the file exists but is invalid, registration fails with a configuration error and leaves the file unchanged.

​
Clone a remote repository

Choose a supported remote onboarding mode and supply the repository URL. Use host SSH configuration, a credential helper, an authenticated provider CLI, or the one-time credential field shown by the UI. Credentials are used for the operation and are not written to maister.yaml.

​
Validation

Registration verifies repository identity, path uniqueness, project slug, manifest structure, Flow bindings, and runner references. Correct every error before retrying; MAIster does not silently substitute another repository, Flow, or runner.

​
Result

The new project appears in the portfolio and project list. Open its board to create the first task or launch a scratch session.