Getting Started
Everything you need before your first Galleon deployment.
Galleon is a web-based platform -- there is nothing to install locally. You sign up, connect your accounts, and deploy from the browser.
Prerequisites
You need two accounts to use Galleon:
- GitHub account -- Galleon authenticates via GitHub OAuth and uses GitHub Actions for CI/CD. Your repositories must be hosted on GitHub.
- AWS account -- Galleon deploys infrastructure to your AWS account. You need admin-level access for the initial setup (to approve a CloudFormation stack that creates an IAM role).
Framework Requirements
Your application should use one of the supported frameworks. The runtime requirements depend on your stack:
| Framework | Runtime |
|---|---|
| Next.js | Node.js 18+ |
| Express | Node.js 18+ |
| React (static) | Node.js 18+ |
| FastAPI | Python 3.9+ |
| Django | Python 3.9+ |
These runtimes need to be available in your project for builds to succeed. Galleon handles the container and infrastructure configuration -- you just need a working application that builds locally.
Sign Up
Go to app.galleonhq.com and click Continue with GitHub. This grants Galleon read access to your repositories so it can detect your framework and set up CI/CD workflows.
No credit card is required to sign up.
Free Trial
Galleon includes a 14-day free trial. The trial clock starts when you trigger your first deployment, not when you create your account. You can take as long as you need to connect your AWS account and explore the platform before the trial begins.
During the trial you have full access to all features -- unlimited apps, all infrastructure tiers, and AI failure analysis.
What Galleon Needs From AWS
Galleon does not store your AWS credentials. Instead, it uses a cross-account IAM role to interact with your account securely.
During onboarding, you will click a link that opens the AWS CloudFormation console with a pre-filled template. This template creates:
- An IAM role that Galleon can assume via AWS STS
- A trust policy scoped to Galleon's AWS account with an external ID (confused deputy protection)
- Permissions to manage the specific AWS services your deployments require (ECS, Lambda, S3, CloudFront, ECR, CloudWatch, etc.)
The setup takes about 60 seconds. You can inspect the CloudFormation template before approving it, and you can revoke access at any time by deleting the stack.
Onboarding Wizard
After signing up, Galleon walks you through a guided onboarding wizard that covers:
- Connecting your AWS account -- Enter your Account ID, approve the CloudFormation stack
- Creating a project -- Name and optional description for grouping your applications
- Connecting a GitHub repository -- Select from your repos, Galleon auto-detects your framework
- Deploying -- Choose an infrastructure tier and trigger your first deployment
The entire process typically takes under 10 minutes. See the Quickstart for a detailed walkthrough of each step.
Next Steps
Ready to deploy? Follow the Quickstart for a step-by-step walkthrough.