Skip to content

Meteor 3.0 Migration Guide

You are reading the migration guide for Meteor 3!

This is a live document which will be updated as development progresses.

This guide is for users with Meteor 2.x projects understand the changes between Meteor 2.x and Meteor 3.0. It's not required to read this guide before starting with Meteor 3.0. To learn Meteor 3.0, we recommend reading the new documentation.

What's the status of version 3.0?

Meteor 3.0 is currently in its official version. Check the documentation for the latest version information.

How to try Meteor 3.0?

You can install the latest Meteor version command below:

bash
  npx meteor

and to create a new Meteor project:

bash
  meteor create

This will prompt the project creator wizard to help you set up a new project.

How to upgrade from Meteor 2.x?

You can upgrade your Meteor 2.x project by running the command below inside your project folder:

bash
meteor update
meteor reset # resets project to a fresh state

If you are upgrade from an older version of Meteor, you might have a different MongoDB driver version. If you encounter issues, consider clearing the local database.

bash
meteor reset --db # resets local db

Also, it's a good idea to completely remove node_modules and the package-lock.json before running meteor npm install:

bash
rm -rf node_modules package-lock.json
meteor npm install

Which will install the necessary packages using the latest Node.js version from Meteor 3.

What this guide will cover?

This guide covers the necessary topics for migrating your application from Meteor 2.x to Meteor 3.0, including:

External Resources

We are aware of these articles and guides to assist with your migration:

Videos

Migrating apps to Meteor 3.0:


If you have a migration guide, either in video or text format, please share it with us to include here.