Docker image to run Meteor apps.
- One image supports every Meteor version (tested with 1.2 - 2.13 and newer)
- Mostly supports Meteor 3 (requires making
programs/server/shrinkwrap.json
writable due to a bug in Meteor 3) - Automatically uses correct node and npm version
- Runs app as non-root user
- Compatible with Meteor up
zodern/meteor
The recommended version. Runs the app as a non-root user.zodern/meteor:root
Compatible with meteord. Runs the app as the root user and has phantomjs installed. Any notes below about permissions do not apply to this image.zodern/meteor:slim
Coming soon. Is a smaller image without node or npm pre-installed. During ONBUILD or when starting the app, it will install the correct version.
This image runs the app with the app
user. The owner of any files or folders your app uses inside the Docker container should be changed to app
.
In your mup config, change app.docker.image
to zodern/meteor
.
If you want to use mup's buildInstructions
option to run commands as root, you can do so by temporarily changing the user:
buildInstructions: [
'USER root',
'RUN apt-get update && apt-get install -y imagemagick graphicsmagick',
'USER app'
]
You can create the bundle with the meteor build
command. The bundle should be available in the container at /bundle/bundle.tar.gz
.
Create a file named Dockerfile
and add the following:
FROM zodern/meteor
COPY --chown=app:app ../path/to/bundle.tar.gz /bundle/bundle.tar.gz
Then build and run the image with
docker build --build-arg EXACT_NODE_VERSION=<true || false> --build-arg NODE_VERSION=<node version> -t meteor-app .
docker run --env NODE_VERSION=<node version> --env EXACT_NODE_VERSION=<true || false> --name my-meteor-app meteor-app
And your app will be running on port 3000
The (--build-arg || --env) NODE_VERSION=<node version>
is optional, and only needed if a command in your docker file will use a specific node or npm version.
If any Node versions in image/setup/versions.json
match the same major version of Node your app needs, the version in versions.json
is used instead since it will have additional security fixes missing in the version Meteor specifies. If there is no matching major version, it will use the exact version Meteor specifies. To always use the exact version, you can use set (--build-arg || --env) EXACT_NODE_VERSION=true
Run
docker run --name my-meteor-app -v /path/to/folder/with/bundle:/bundle -p 3000:3000 -e "ROOT_URL=http://app.com" zodern/meteor
Built app
refers to an uncompressed bundle that already has had it's npm dependencies installed.
When using a compressed bundle, the bundle is decompressed and the app's npm dependencies are installed every time the app is started, which can take a while. By using this method instead, both steps are done before the container is started, allowing it to start much faster. Meteor up's Prepare Bundle
feature uses this.
Before following the instructions in either of the next two sections, build your app with meteor build --directory ../path/to/put/bundle
.
The bundle should be available in the container at /built_app
.
Create a file named Dockerfile
and copy the following into it:
FROM zodern/meteor
COPY --chown=app:app ./path/to/bundle /built_app
RUN cd /built_app/programs/server && npm install
Then build and run your image with:
docker build -t meteor-app --build-arg NODE_VERSION="node version" .
docker run --name my-meteor-app -p 3000:3000 -e "ROOT_URL=http://app.com" meteor-app
If possible, you should create a docker image as described in the previous instructions since it is more reliable.
First, make sure you have the correct version of node installed for the Meteor version your app uses, and then run
cd /path/to/bundle
cd programs/server
npm install
Next, start the docker container with
docker run --name my-meteor-app -v /path/to/bundle:/built_app -p 3000:3000 -e "ROOT_URL=http://app.com" zodern/meteor
When using a compressed bundle, you can specify the arguments used when running npm install
by setting the environment variable NPM_INSTALL_OPTIONS
.
Tests can be run with npm test
. The tests can not be run on Windows, though WSL does work. Docker should be installed before running the tests.
Commit messages should start with one of these to allow the changelog and version to be updated correctly:
fix:
fixes a bugfeat:
adds a featureperf:
docs:
chore:
ci:
If the change is a breaking change, add BREAKING CHANGE:
to the commit description