Manage a project
A project groups apps, databases, and jobs in an organization. Project membership controls who can access those resources, so two people in the same organization can see different projects. Each member has a project role of admin, member, or viewer.
Create a project
Section titled “Create a project”- Press
CMD + Kon macOS orCTRL + Kon other systems. - Select New project.
- In Project name, enter a name.
- Select Create project.
orchard project create --name "Acme API"Add a member
Section titled “Add a member”- Open the project.
- Select Members.
- Select Add people.
- In Find people to add, find each person.
- Select Next.
- In Role, select a role.
- Select Add
<name>.
The --role flag accepts admin, member, or viewer. An email address without an account receives an invitation.
Invitations that are not accepted yet appear under Invitations. Each invitation shows its expiry date. To cancel an invitation, select the delete icon on the invitation.
To remove a member, select the delete icon on the member. The person loses access to the project.
Change the name and appearance
Section titled “Change the name and appearance”- Open the project.
- Select the Customize icon in the project header.
- Update Name, Description, Icon, or Background.
- Select Save.
To turn off the animated background in your browser, refer to Set your preferences.
Transfer ownership
Section titled “Transfer ownership”The project owner’s resource allowance pays for everything in the project. A transfer moves that cost to another member’s allowance, and the new owner must accept it. For the rules and CLI commands, refer to Transfer project ownership.
- Open the project.
- Go to Settings > Danger zone.
- In Transfer ownership, select Transfer.
- In New owner, select a member of the project.
- Select Send request.
The row shows Waiting on the new owner to accept. until the request ends.
Move a project to another organization
Section titled “Move a project to another organization”You must be an owner or admin of the organization the project is in, and be able to create projects in the destination organization. If the project would put the destination organization over its limits, you must also be an admin there.
- Open the project.
- Go to Settings > Danger zone.
- In Move to another organization, select Move.
- In Organization, select the destination.
- In Slug, confirm the project slug. The slug must be free in the destination organization.
- Read the preview of what changes.
- Select Move project. If the preview shows New database backups stop, this button is Move anyway.
The preview can show these messages:
| Message | Meaning |
|---|---|
<n> members lose access | These members are not in the destination organization. |
| You become the owner | The current owner is not in the destination organization. The project counts against your allowance. |
Over <organization>’s quota | The move goes through, but new deploys in the destination can be blocked until there is room. |
| New database backups stop | The destination has no backup storage. Databases keep running, but they take no new backups. Existing backups stay restorable. |
| Backups keep running | Databases start to archive to the destination’s backup storage. Existing backups stay restorable. |
Delete a project
Section titled “Delete a project”- Open the project.
- Go to Settings > Danger zone.
- In Delete project, select Delete.
- Select Delete project forever.
Related resources
Section titled “Related resources”- Manage variables and environments - Configure the apps inside a project.
orchard projectreference - Every project command and flag.