# Project

### What is it ?

Projects are central point of Free Commit. This is a configuration, builds are launched from here.

### Creation

On GUI, you can create a project from another project, to do this click on "by model".

<table><thead><tr><th width="206">Field</th><th width="415">Description</th><th>Required</th></tr></thead><tbody><tr><td>Name</td><td>Name of project</td><td>Yes</td></tr><tr><td>Description</td><td>Used only for information</td><td>No</td></tr><tr><td>Number build to keep</td><td>After each build, the lastest builds are cleared. Helps protect your disk space</td><td>Yes</td></tr><tr><td>Allow concurrent execution</td><td><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span>Ask yourself if the external systems on which you deploy support the competition. This is not the case for cloudflare workers and can cause a denial of service</td><td>Yes</td></tr><tr><td>Repository credential</td><td>No value if public, created credential otherwise. See <a data-mention href="provider-credentials">provider-credentials</a></td><td>No</td></tr><tr><td>Repository</td><td>SSH url of you project</td><td>Yes</td></tr><tr><td>Branch</td><td>Used for check if project is concerned by event. If event doesn't have specific branch (issue comment etc), put "*". See <a data-mention href="../build">build</a>for more</td><td>Yes</td></tr><tr><td>Deployment file path</td><td>Path to your deploy specifications file. (/.free-commit/deploy.yaml if your file is at the .free-commit directory)</td><td>Yes</td></tr><tr><td>Allowed developers</td><td>User with developer role only who can launch this build</td><td>No</td></tr></tbody></table>
