Skip to main content

Run locally

Running existing templates with Monk is very straightforward. Running them locally is useful for testing and one-off deployments on single machines.

This short tutorial shows how to run templates locally. We'll run MongoDB on Monk. Make sure you have Monk installed and monkd running. If not, follow this guide โ†’

Browsing available templates

There are many templates to choose from, they're all available in the Monk Hub.

To find interesting packages, browse the GUI, or run:

monk list

to see a list of available ones. You can narrow down search with the following arguments:

monk list --help

monk list [command options] [arguments...]

--runnables, -r (default: false)
--groups, -g (default: false)
--local, -l (default: false)
--help, -h show help (default: false)

In this example we use a MongoDB template published by Monk. It is based on Bitnami's MongoDB container image. You can pick any other template from the available ones of course.

To install MongoDB, simply run:

monk run mongodb/latest

That's it! MongoDB is running on your machine. You can connect to localhost:27017 and put some data in it.


Let's suppose that a new version of MongoDB came out. The maintainer of mongodb/latest will update their template to a new version and publish it to the Monk Hub.

In order to update the already running template to its newest available version you just have to do:

monk update mongodb/latest

That's it! The containers will be updated and re-spawned from the newest images, the storage associated with the template will be preserved.


In order to stop the template do:

monk stop mongodb/latest

This will stop the template but it will not touch its storage so if you decide to run mongodb/latest again, the data will be there.


We have learned how to run, update and stop templates locally and how to browse the available ones. Monk will happily run even the largest system on your laptop if you want but its true value lies in clusters. Move to the next guide to learn how to create a Monk cluster.

Rate this page