Meteor CLI
Deploy your Meteor app to Galaxy from the terminal with one command.
Deploying a Web App?
This guide is for Meteor apps. For Node.js, AdonisJS, or Python, use the Galaxy CLI instead.
Prerequisites
- Meteor CLI installed
- A Galaxy account
- A payment method added for identity verification
Log in before deploying:
meteor loginDeploy
The basic command:
meteor deploy myappThat's it. Galaxy creates your app on the Free plan with a Tiny container and deploys it to US East.
Use an App Name, Not a Domain
Pass a simple app name (like myapp), not a full domain (like myapp.example.com). A domain format is treated as a custom domain assignment, which requires a paid plan. On the Free plan it fails with Free apps must use a free-tier domain. Use a simple name and let Galaxy generate the hostname (myapp.us.galaxycloud.app).
Regions
Set DEPLOY_HOSTNAME to deploy to a different region:
| Region | DEPLOY_HOSTNAME |
|---|---|
| US East (default) | us-east-1.galaxy-deploy.meteor.com |
| EU West | eu-west-1.galaxy-deploy.meteor.com |
| Asia Pacific | ap-southeast-2.galaxy-deploy.meteor.com |
DEPLOY_HOSTNAME=eu-west-1.galaxy-deploy.meteor.com meteor deploy myappWindows
Use SET DEPLOY_HOSTNAME=eu-west-1.galaxy-deploy.meteor.com before running meteor deploy.
Plan and Container Size
meteor deploy myapp --plan professional --container-size standardPlans: free, essentials, professional. Container sizes: tiny, compact, standard, double, quad, octa, dozen.
Settings
Pass your configuration via a settings file:
meteor deploy myapp --settings settings.jsonSettings persist across deployments until you specify a new file. See the Meteor Reference for the settings structure.
Database
Add a free shared MongoDB to your deployment:
meteor deploy myapp --mongoFor a free plan app with a database:
meteor deploy myapp --free --mongoFree MongoDB Limitations
The shared cluster doesn't include backups. Not recommended for production. See the Meteor Reference for SSL configuration.
CI/CD with Deployment Tokens
Use a deployment token instead of personal credentials for automated pipelines.
Generate a token
METEOR_SESSION_FILE=token.json meteor loginThis creates token.json with a session token valid for 90 days.
Use in your pipeline
METEOR_SESSION_FILE=token.json meteor deploy myapp --settings settings.jsonKeep Tokens Secure
Store tokens in your CI/CD platform's secret storage (GitHub Secrets, GitLab Variables). Never commit them to your repo.
Flag Reference
| Flag | Description |
|---|---|
--free | Deploy on the free plan |
--plan [plan] | Set plan: professional, essentials, or free |
--mongo | Provision a free shared MongoDB |
--container-size [size] | Set container size |
--settings [file] | Pass a JSON settings file |
--cache-build | Reuse build if git commit is unchanged (Meteor 1.11+) |
--debug | Deploy without minifying code |
--no-wait | Exit after upload, don't wait for deployment |
--deploy-polling-timeout [ms] | Deployment wait timeout (default: 15 min) |
--owner [user/org] | Deploy under a specific account |
--delete, -D | Permanently delete the app |
meteor authorized Is No Longer Supported
Changing app ownership from the CLI is deprecated. Move apps between accounts from the dashboard instead. See Transfer an App.