Standalone install

This method of installing requires just PHP to be installed. It is the simplest method and a good way to get started. It will work for projects of any size.

sudo wget -O /usr/bin/mongrate
sudo chmod +x /usr/bin/mongrate
sudo wget -O /etc/mongrate.yml

Now verify the install has been successful by running mongrate. You should see a list of available commands, and no error messages.

If successful, you can now configure mongrate in /etc/mongrate.yml.


By default, you should configure Mongrate in /etc/mongrate.yml

Parameter Required? Description
mongodb_server yes URI for your MongoDB server.
mongodb_db yes Database name.
migrations_directory yes The directory where your migration files are to be kept.

Symfony integration

In addition to the standalone installation, there is a Symfony bundle, which lets you use the Mongrate commands by running your app/console (bin/console in Symfony3).

For information, see this page.


Installing via Puppet couldn’t be easier.

For information, see this page.


Installing via Ansible is also easy. See this page.