---
title: Getting Started
description: Create your Atlasflow account, connect GitHub, and deploy your first project.
order: 0
---

Atlasflow deploys containerized applications from GitHub repositories. This guide walks through account setup, connecting GitHub, and creating your first project.

## Create an account

Sign up at [Atlasflow](https://app.atlasflow.com/signup) and verify your email address with the 6-digit code we send you. You'll land in your personal workspace after signing in.

A [workspace](/docs/concepts/workspaces.md) is the billing and resource boundary that contains your projects. You can create more workspaces later, for example to separate personal projects from team work.

## Choose a plan

Deployments require an active subscription. Pick a plan during onboarding or from your workspace billing settings:

| Plan  | Minimum monthly usage | Best for                        |
| ----- | --------------------- | ------------------------------- |
| Hobby | $5                    | Side projects and experiments   |
| Pro   | $20                   | Production apps and small teams |
| Team  | $100                  | Teams shipping at scale         |

Each plan includes that amount in usage credits every month, and you're only billed for resource usage beyond your credits. See [Plans](/docs/billing/plans.md) for the full comparison.

## Connect GitHub

Atlasflow uses a GitHub App to access your repositories. When you create a project, you'll be prompted to install the Atlasflow GitHub App on your account or organization.

Grant access to the repositories you want to deploy. You can adjust repository access later in your GitHub settings, and reconnect from a project's settings if access changes.

## Create a project

1. Open your workspace and choose **New project**.
2. Select a GitHub repository. Each project maps to one repository.
3. Configure the project:
   - **Project name**: defaults to the repository name.
   - **Root directory**: subdirectory containing your app (use `/` for the repo root). See [Monorepos](/docs/guides/monorepos.md).
   - **Dockerfile path**: path to your Dockerfile (defaults to `Dockerfile`). If no Dockerfile exists, Atlasflow auto-detects your stack and builds your app. See [Supported frameworks](/docs/guides/supported-frameworks.md).
4. Optionally add environment variables during setup.
5. Create the project.

After creation, Atlasflow triggers an initial deployment from your repository's default branch.

> **Note:** Make sure your app listens on **port 3000** and responds to `GET /` with a **2xx** status before deploying. See [Container requirements](/docs/guides/container-requirements.md).

## Next steps

- [Deploy your first project](/docs/guides/first-deployment.md): understand the deployment lifecycle.
- [Core concepts](/docs/concepts.md): learn the objects you'll work with.
- [Container requirements](/docs/guides/container-requirements.md): confirm your app is compatible.