Docker Runtime for Meteor Apps

Meteor Dockerized for Development and Production.

What is this image?

When working with Meteor and Docker, there are two most common tasks that you will face:

Local Meteor development with docker-compose;
Building a production Docker image for your app.

This image is an attempt to solve both problems.

How to use this image?

Local development

When working with this image locally, all you need to do is to mount a folder with you source code to /app volume of the container.

Here is the docker-compose example:

version: '3'

services:
  meteor-app:
    image: 129966181679.dkr.ecr.us-east-1.amazonaws.com/meteor
    restart: unless-stopped
    links:
      - mongo
    volumes:
      - ./:/app
    ports:
      - 80:80
    environment:
      MONGO_URL: mongodb://mongo
      ROOT_URL: http://localhost
      
  mongo:
    image: mongo

By doing this you will have you Meteor app listening on http://localhost:80 and hot code pushes working.

Building an image for your app

That's simple. Really. Just add the following Dockerfile into the root of your app:

FROM codexsystems/meteor

Then you can build the docker image with:

docker build -t yourname/app .

Then run it:

docker run -d \
    --link mongo \
    -e ROOT_URL=http://localhost \
    -e MONGO_URL=mongodb://mongo \
    -p 80:80 \
    yourname/app

And access it via http://localhost:80.

Running existing Meteor bundle

In case if you already have a Meteor bundle created for you app (for example with some CI service), you can use it instead of building a new bundle from the source code.

All you need to do in such case is to have your bundle directory or your bundle.tar.gz file in the project document root during Docker image build process.

Configuration

This image supports the same environment variables, as Meteor does.

However, there are also few additional environment variables supported that are used for better image usability:

METEOR_SETTINGS_FILE - In the Local development mode, this image will try to locate your settings.json file and attach it to the Meteor. You can use this environment variable if your settings file is named somehow else. Default value: settings.json.