Deploy Web Apps
Deploy Node.js, Python, and AdonisJS applications directly from your Git repository with zero downtime.
Prerequisites
- A Galaxy account
- Your app in a Git repo (GitHub or Bitbucket)
- A payment method added for identity verification
1. Choose Your App Type
Select the type that matches your application:
- Node.js: JavaScript and TypeScript apps (versions 18, 20, and 22 supported)
- Python: Flask, Django, FastAPI, and other frameworks (versions 3.13, 3.12, 3.11, and 2.7 supported)
- AdonisJS: TypeScript-first Node.js framework (AdonisJS 6, pre-configured)
AdonisJS Gets First-Class Support
AdonisJS has its own dedicated app type. Don't select Node.js and configure it manually.
2. Deploy
Connect your repo
Go to your Galaxy dashboard, click Create New, then Deploy New App. Select your app type and connect your GitHub or Bitbucket account.
Bitbucket: Register Webhooks First
If a warning banner appears on the Repository step, click Register webhooks now, select your workspaces, and click Register Webhooks.
Select repo and branch
Pick your repository and the branch to deploy from (usually main).
Choose plan and container
Select a plan (Sandbox for testing, Production for live apps) and a container size. Start small, scale later. See Web Apps Billing for pricing details.
Choose Your Plan and Container Size
Now you're picking the resources for your app.
Which Account?
If you're working with an organization, select it here. Otherwise, your personal account is already selected.
Pick Your Plan
Galaxy offers flexible plans: Sandbox (free, for testing), Production (for live apps), and Business (enterprise, coming soon). Each supports different container sizes and features.
Not sure which one is right for you? Start with Production for live apps, or Sandbox for testing and development. You can upgrade or downgrade anytime based on what you actually need.
For detailed pricing and feature comparisons, check out the Web Apps Billing documentation.
Plans Are Flexible
You can change plans anytime after deployment. Don't overthink this choice.
Select Your Container Size
Container size determines how much RAM and CPU your app gets. Bigger containers handle more traffic and heavier workloads, but cost more to run.
Start with a smaller container and scale up if you hit performance limits. Most apps do just fine starting smaller and growing as needed.
For the complete breakdown of container sizes, CPU allocations, and pricing, see the Web Apps Billing documentation.
Configure and Deploy
You're almost there. This final step is where you customize the deployment itself.
App Configuration
App Display Name: Give your application a friendly name. This is just for your reference in the Galaxy dashboard (it's not used in the URL).
Branch: Which branch should Galaxy watch and deploy from? Most teams deploy from main or master, but choose whatever branch makes sense for your workflow. Every push to this branch triggers an automatic deployment.
Custom Subdomain: Choose a memorable subdomain for your app (3-63 characters). This becomes your default URL (like myapp.sandbox.galaxycloud.app). Don't worry too much about it, though. You can always add a custom domain later.
Region: Galaxy runs your application across multiple regions to reduce latency:
- us-east-1 (Virginia, United States): East Coast and general US traffic
- eu-west-1 (Roubaix, France): European users
- ap-southeast-2 (Sydney, Australia): Asia Pacific users
Region Selection by Plan
Sandbox (free) apps are deployed to us-east-1 by default and don't include region selection. Production plans can choose any region during deployment. Want to change regions later? Upgrade to Production from your app's dashboard.
Build Configuration
This section varies depending on which app type you selected in Step 1.
- Docker Preset: Node.js version (18, 20, or 22 LTS)
- Install Command: Usually
npm install - Build Command: Optional. Use
npm run buildfor TypeScript or bundling - Start Command: Usually
npm start
- Docker Preset: Python version (3.12 or 3.13 recommended)
- Install Command: Usually
pip install -r requirements.txt - Build Command: Optional. Most Python apps don't need one
- Start Command: Like
python main.pyorgunicorn app:app
AdonisJS apps come pre-configured. Install, build, and start commands are pre-filled.
Hit Deploy. Galaxy builds your app, starts your container, and runs health checks. Within a few minutes your app is live.
Every push to your deploy branch triggers a new deployment automatically.
3. Configure (Optional)
Region: us-east-1 (Virginia), eu-west-1 (Roubaix, France), or ap-southeast-2 (Sydney). Sandbox apps deploy to us-east-1 by default.
Health Check Path: Optional endpoint Galaxy pings to verify your app is running (like / or /health).
Pre-deploy command: Run database migrations or other tasks before the new version goes live (paid plans only).
Custom domain: Your app gets a default URL like myapp.sandbox.galaxycloud.app. You can add a custom domain later.