# Meteor.js

## Overview

Clever Cloud allows you to deploy any Meteor.js application. This page will explain how to set up your application to run it on our services.

Be sure your `.meteor` folder is in your git repository.

{{% content "create-application" %}}

{{% content "set-env-vars" %}}

## Configure your Meteor.js based application

### Mandatory configuration

#### Set up environment variables

To run your Meteor.js application you need a few mandatory environment variables:

* `MONGO_URL`: this is the mongo uri you can find in your mongodb's dashboard, it has to start with `mongodb://`
* `ROOT_URL`: this is your application's root url. It has to start with `http://` or `https://`
* `PORT`: keep the current value of 8080

With Meteor 2.6.n comes MongoDB 5.n and [the new npm driver](https://guide.meteor.com/2.6-migration.html). You need to append `?directConnection=true` in your `MONGO_URL` to avoid the new mongo driver Service Discovery feature.

#### Optional Meteor settings as environment variable

Some application require a `settings.json` file to [store api keys and other various private and public Meteor variables](https://v2-docs.meteor.com/api/core#Meteor-settings).
You can declare a `METEOR_SETTINGS` environment variable and past the content of the json file as the value of this key.

## Specify required Node.js version

Since building with the latest version of Node.js might fail, you should specify in the `package.json` file of the application the version needed for your Meteor application ; as shown in [Deploying Node.js apps](/doc/applications/nodejs/#requirements) documentation.
To find out which version is required by your application type the following command `meteor node -v` inside root folder.

Currently with Meteor *2.6.1* the Node.js version is *14.18.3* so you should add the following inside the `package.json` file.

```json
  …
  "engines": {
    "node": "14.18.3"
  },
  …
```

You may change the node version value according to the application requirements.

### Activate the dedicated build

Meteor.js uses a lot of memory during the build. You most likely will need to activate the [dedicated build feature](/doc/administrate/apps-management/#edit-application-configuration) and set your vertical scaling size at least to **M**.

If your build still fails after you enabled the feature, please contact us on the support so we can set you a bigger scaler.

### Automatic HTTPS redirection

You can use the [force-ssl](https://atmospherejs.com/meteor/force-ssl) atmosphere package to redirect your users to the HTTPS version of your application.

### Custom start parameters

If you want to set custom start parameters, the main entry point of built meteor applications is: `.build/bundle/main.js`.
Add in the `scripts.start` field of the package.json: `node .build/bundle/main.js <parameters>`

### Deployment process on Clever Cloud

At each deployment, the needed Meteor.js version will be read from `.meteor/release` and installed.
Your application will then be built using `meteor build --server-only` and deployed from the files created by this command.

 {{% content "env-injection" %}}

 {{% content "deploy-git" %}}

 {{% content "link-addon" %}}

### Oplog Tailing

Oplog tailing is supported on dedicated databases (starting from Hazelnut size). Contact the support to enable oplog. Once enabled, set the following environment variable:

* `MONGO_OPLOG_URL`: `mongodb://[…]mongodb.services.clever-cloud.com:{DB_PORT}/local?authSource={DB_NAME}`

Since Meteor 2.6.n the mongo driver detect the `MONGO_OPLOG_URL` by itself and you should not add this to your environment variables.

## Migrate from a Node.js instance

If you want to migrate from your classic node.js app to a meteor application, contact [Clever Cloud Support](https://console.clever-cloud.com/ticket-center-choice) with the application id.

{{% content "more-config" %}}

{{% content "url_healthcheck" %}}

{{% content "request-flow" %}}