Manage projects

This page shows how to work with projects. For what projects are and how they relate to organizations and services, read Accounts, organizations, and projects.

Every service lives in one project, and the CLI always acts on your active project.

Create a project

acc projects create --name my-app
acc projects list

In the web app, open Projects and create one from there. The new project belongs to the organization you currently have selected.

See and switch the active project

acc whoami               # shows who you are and the active project
acc projects switch      # pick from a list
acc projects switch <id> # or name the project directly

To act on another project for one command, pass it explicitly:

acc services list -p <project-id-or-name>
acc deployments --project <project-id-or-name>

Point CI or an agent at a project

Set two environment variables. Every command then runs against that project without prompts; add -y to commands that ask for confirmation.

export AF_TOKEN="..."        # a personal access token, see Create and use access tokens
export AF_PROJECT_ID="..."   # from acc projects list
acc whoami --json
acc services deploy -y

Use one project per environment (for example my-app-staging and my-app-production) and give each pipeline its own AF_PROJECT_ID.

Rename a project

acc projects update <id>

Invite people

People are invited at the organization level, and access to projects is set per person. In the web app, open Members (owners and admins only) and send an invitation. Choose a role, and for a member, choose whether they can see all projects or only selected ones. Inviting requires an active paid subscription.

Roles are explained in Accounts, organizations, and projects.

Delete a project

Deleting a project deletes every service in it and closes their deployments.

acc projects delete <id>

Before deleting, run acc services list -p <id> and make sure nothing there is still needed.

Next steps

• Accounts, organizations, and projects
• Create and use access tokens
• Manage billing and credits