Running on Galaxy Legacy? Visit the legacy docs.
Galaxy
Meteor

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

Log in before deploying:

meteor login

Deploy

The basic command:

meteor deploy myapp

That's it. Galaxy creates your app on the Free plan with a Tiny container and deploys it to US East.

Regions

Set DEPLOY_HOSTNAME to deploy to a different region:

RegionDEPLOY_HOSTNAME
US East (default)us-east-1.galaxy-deploy.meteor.com
EU Westeu-west-1.galaxy-deploy.meteor.com
Asia Pacificap-southeast-2.galaxy-deploy.meteor.com
DEPLOY_HOSTNAME=eu-west-1.galaxy-deploy.meteor.com meteor deploy myapp

Windows

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 standard

Plans: 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.json

Settings 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 --mongo

For a free plan app with a database:

meteor deploy myapp --free --mongo

Free 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 login

This 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.json

Keep Tokens Secure

Store tokens in your CI/CD platform's secret storage (GitHub Secrets, GitLab Variables). Never commit them to your repo.


Flag Reference

FlagDescription
--freeDeploy on the free plan
--plan [plan]Set plan: professional, essentials, or free
--mongoProvision a free shared MongoDB
--container-size [size]Set container size
--settings [file]Pass a JSON settings file
--cache-buildReuse build if git commit is unchanged (Meteor 1.11+)
--debugDeploy without minifying code
--no-waitExit 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, -DPermanently delete the app

Troubleshooting


What's Next?