Skip to main content
Deploying applications on Unkey is in public beta. To try it, select Projects in the dashboard sidebar and create a project. Deployed resources are free until August 1, 2026. We’re eager for feedback, so let us know what you think on Discord, X, or email support@unkey.com.
A project is the top-level organizational unit for deploying applications on Unkey. Each project maps to a single codebase (typically a GitHub repository) and groups the apps, environments, and configuration needed to build, deploy, and run your application.

​
Project hierarchy

Projects live inside a workspace. A project contains one or more apps, and each app has its own environments, deployments, and configuration.
An app represents a single deployable service within your project. When you create a project, Unkey creates a default app automatically. A project can contain multiple apps, for example an API server and a background worker that share the same repository. Build settings, runtime configuration, and gateway policies are configured per app. Variables and custom domains are scoped to an app’s environment.

​
Create a project

  1. Navigate to your workspace’s Projects page.
  2. Click New project.
  3. Enter a project name. Unkey generates a URL-friendly slug from the name, which you can edit.
  4. Connect your GitHub account if you haven’t already. You can skip this step and connect later.
  5. Select the repository to deploy from your connected GitHub accounts. To finish onboarding without a repository, for example, if you plan to deploy with the CLI or want to connect GitHub later, click Skip for now.
  6. Configure initial build and runtime settings. You can change these later.
  7. Click Deploy to trigger your first deployment.
The slug must be unique within your workspace and can only contain lowercase letters, numbers, and hyphens. If you skipped the repository step, the project is created without a connected repo. You can connect one later from the project’s Settings tab and trigger your first deployment from there.

​
Project dashboard

After creation, the project dashboard gives you four tabs: The deployments tab is the default view when you open a project.

​
Delete a project

Deleting a project permanently removes all deployments, environments, custom domains, variables, and associated data. This action cannot be undone.
To delete a project:
  1. Open the project actions menu (three-dot icon on the project card).
  2. Select Delete project.
  3. Check the confirmation box acknowledging the permanent deletion.
  4. Confirm the deletion.
Deletion is asynchronous. Unkey removes all associated resources (deployments, environments, domains, variables) in the background. The project disappears from your workspace immediately, but cleanup of underlying resources completes shortly after.
Last modified on June 24, 2026