Create your first project

A project is the container for one application: its databases, files, functions, keys and settings. You create one from the Projects page.

Create a project

1. Sign in and open Projects (the home page of the Console).
2. Choose Create Project. If you have none yet, the button reads Create Your First Project. A + New button next to the project switcher does the same.
3. In Create New Project, type a Project Name. A Project ID / Slug is suggested from the name with a short random ending.
4. Optional: edit the slug. It is checked for availability as you type and the form will not submit while it is taken.
5. Under Project Template / Architecture, choose one:
   • Blank Project (the default): no database yet. A clean workspace you add to later.
   • Add Database: creates an empty PostgreSQL database with the project, with a SQL editor and schema tools ready.
6. If you chose Add Database, pick the PostgreSQL Engine Version and, if you like, tick the Database Extensions to switch on. See PostgreSQL versions and upgrades and Extensions.
7. Choose Create Project.

You land on the project's Overview with a message that the project was created. The region is assigned automatically; there is no region picker in the form.

What the slug is

The slug is a short unique ID for the project. Rules: 3 to 48 characters, lowercase letters, numbers and hyphens, not starting or ending with a hyphen, not a reserved word, and not starting with p- or prj-. It is used in console addresses such as /projects/your-slug. It cannot be changed later, but you can rename the project (see Project settings).

What you get

• A project in your current organization. See Organizations and projects.
• Two API keys, named Default Secret Key and Default Publishable Key. For safety their values are not displayed when the project is created. To get a key you can copy, create a new one in Project Settings. See API keys.
• If you chose Add Database: a database whose connection details are on the Connection page. See Connection strings.

Add a database to a Blank Project

If you started blank, open Databases in the sidebar and choose Create Database, or use the + New Database... option in the database picker. See Create a database.

Good to know

• Your role must allow writing. Viewer and Billing roles in an organization cannot create projects.
• If your account is paused for unpaid usage, creating projects is blocked until it is resolved. See When your balance runs low or empty.
• A project can be deleted only after its tables, functions, stored files, containers and actions are removed. See Project settings.

Next step

Take the tour of the Console.