Quickstart
Deploy your first application to your own AWS account in under 10 minutes. This walkthrough covers the entire process from sign-up to a running deployment.
Prerequisites
- A GitHub account with at least one repository containing a deployable application
- An AWS account (with admin access for the initial CloudFormation setup)
Step 1: Sign Up
Go to app.galleonhq.com and click Continue with GitHub. Galleon uses GitHub OAuth for authentication -- no separate password to manage.
After signing in, you will be dropped into the onboarding wizard, which walks you through the remaining steps.
Step 2: Connect Your AWS Account
The onboarding wizard prompts you to connect your AWS account.
- Enter your 12-digit AWS Account ID.
- Click Connect via AWS Quick Create. This opens the AWS CloudFormation console with a pre-filled template.
- In the AWS console, review the stack and click Create stack.
The CloudFormation stack creates a cross-account IAM role that allows Galleon to provision infrastructure on your behalf. Your AWS credentials never leave your account -- Galleon assumes the role using AWS STS with an external ID for security.
The stack takes about 60 seconds to complete. Galleon detects the connection automatically and advances to the next step.
Step 3: Create a Project and Connect a Repository
The wizard prompts you to:
- Create a project -- Give it a name and an optional description. Projects group related applications and AWS connections.
- Connect a GitHub repository -- Select a repository from your GitHub account. Galleon scans the repo and auto-detects your framework (Next.js, FastAPI, Django, Express, React, etc.).
If your repository is a monorepo, Galleon detects multiple applications and lets you deploy each one independently.
Step 4: Deploy
With your repo connected, the wizard presents deployment options:
- Choose an infrastructure tier -- Serverless, Starter, Growth, or Scale. Galleon recommends a tier based on your detected framework, but you can override it.
- Click Deploy -- Galleon generates Terraform configuration and a GitHub Actions workflow, commits them to your repository, and triggers the first deployment.
- Watch live logs -- The deployment log streams in real time directly in the Galleon UI. You will see each step as it executes: Terraform init, plan, apply, health checks, and completion.
When the deployment succeeds, you will see the deployment URL where your application is live.
What Happens Next
After the initial deployment, your CI/CD pipeline is fully set up:
- Push to main triggers a redeployment automatically via the GitHub Actions workflow that Galleon committed to your repo.
- Deployment status is tracked in the Galleon dashboard with live logs for every run.
- Failure analysis kicks in automatically if a deployment fails -- Galleon analyzes the logs, identifies the root cause, and opens a fix PR on your repository.
You do not need to return to the onboarding wizard. All subsequent management happens from the Galleon dashboard or through your normal git workflow.
Next Steps
- Deployments -- Understand deployment tiers, blue-green strategies, and rollback behavior
- Supported Frameworks -- See the full list of auto-detected frameworks and stack configurations
- Infrastructure Tiers -- Compare Serverless, Starter, Growth, and Scale tiers in detail