meteor deploy

Deploy your Meteor application to Galaxy

The meteor deploy command deploys your Meteor application to Galaxy, Meteor’s hosting service.

Usage

meteor deploy <site> [options]

Basic Usage

Deploy to a meteorapp.com subdomain:

meteor deploy myapp.meteorapp.com

You can deploy to any available name under meteorapp.com without additional configuration.

Custom Domains

To deploy to a custom domain:

meteor deploy myapp.mydomain.com

You’ll also need to configure your domain’s DNS records. See the Galaxy DNS documentation for details.

Options

--settings · string

Set optional data for Meteor.settings. This will be available at runtime in Meteor.settings on the server. If the object contains a key named public, then Meteor.settings.public will also be available on the client. The argument is the path to a JSON file. Settings persist across deployments until you specify a different settings file. To unset settings, pass an empty settings file.

--debug · boolean · default: "false"

Deploy in debug mode (don’t minify, etc)

--delete · boolean · default: "false"

Permanently delete this deployment, including all of its stored data

--allow-incompatible-update · boolean · default: "false"

Allow packages in your project to be upgraded or downgraded to versions that are potentially incompatible with the current versions, if required to satisfy all package version constraints.

--deploy-polling-timeout · number · default: "900000"

The number of milliseconds to wait for build/deploy success or failure after a successful upload of your app’s minified code. Defaults to 15 minutes.

--no-wait · boolean · default: "false"

Exit when Meteor has uploaded the app’s code instead of waiting for the deploy to conclude

--cache-build · boolean · default: "false"

Reuse the build already created if the git commit hash is the same

--free · boolean · default: "false"

When deploying an app for the first time, deploy in Galaxy’s free mode

--plan · string

Change the app plan. Valid values: professional, essentials, or free. This argument overwrites the --free argument.

--mongo · boolean · default: "false"

If true and no mongo URL is provided in settings (galaxy.meteor.com.env.MONGO_URL), Galaxy will create a database for your app in its shared cluster and insert the URL in your app’s settings.

--container-size · string

Change your app’s container size using the deploy command. Valid values: tiny, compact, standard, double, quad, octa, or dozen.

Examples

Deploy with settings:

meteor deploy myapp.meteorapp.com --settings settings.json

Deploy in debug mode:

meteor deploy myapp.meteorapp.com --debug

Deploy as a free app:

meteor deploy myapp.meteorapp.com --free

Deploy with a specific plan:

meteor deploy myapp.meteorapp.com --plan professional

Deploy with a specific container size:

meteor deploy myapp.meteorapp.com --container-size standard

Deploy with automatic MongoDB provisioning:

meteor deploy myapp.meteorapp.com --mongo

Deploy without waiting for completion:

meteor deploy myapp.meteorapp.com --no-wait

Delete a deployment:

meteor deploy myapp.meteorapp.com --delete

Settings File

The --settings flag allows you to pass deploy-specific configuration to your application:

{
  "public": {
    "analyticsKey": "xyz123"
  },
  "private": {
    "apiKey": "secret123"
  }
}

Server-side code can access all settings:

Meteor.settings.private.apiKey // "secret123"

Client-side code can only access public settings:

Meteor.settings.public.analyticsKey // "xyz123"

Managing Authorization

Use the meteor authorized command to manage who can deploy to a site:

# List authorized users
meteor authorized myapp.meteorapp.com

# Add a user
meteor authorized myapp.meteorapp.com --add username

# Remove a user
meteor authorized myapp.meteorapp.com --remove username

# Transfer ownership (Galaxy only)
meteor authorized myapp.meteorapp.com --transfer username

Galaxy Plans

Galaxy offers different hosting plans:

• Free: For development and testing
• Essentials: For production apps with basic needs
• Professional: For production apps with advanced features

You can change plans using the --plan option:

meteor deploy myapp.meteorapp.com --plan professional

Container Sizes

Available container sizes (from smallest to largest):

• tiny
• compact
• standard
• double
• quad
• octa
• dozen

Change container size:

meteor deploy myapp.meteorapp.com --container-size double