Meltano is a powerful combination of command line tool and web app. It leverages the file system, coordinates across databases, and automates data extraction, loading, and transforming in addition to providing reporting and dashboarding. As such, installing and getting up and running takes a bit longer than double-clicking an installer. At least for now...




  • Git: to version control your Meltano project
  • Docker Desktop: to create a sample/default database


Meltano provides a command line interface (CLI) to kick start and help you manage the configuration and orchestration of all the components in the data life cycle. It provides a single source of truth for the entire data pipeline. The CLI makes it easy to develop, run, and debug every step of the data life cycle.

Let's make sure our requirements are up to date:


You may refer to for platform specific installation instructions.

$ python --version
Python 3.6.1


Run pip install --upgrade pip to update pip to the latest version.

$ pip --version
pip 10.0.1 from … (python 3.6)


If pip/python is not working, try pip3/python3 instead. This would be the case if you have both Python 2+ and 3+ installed.


Open your terminal in the directory where you want Meltano installed. For example /Users/YOUR_USER_NAME/Documents/Meltano.


We currently require installing Meltano using Python 3's virtual environment (venv snippet below) to isolate it from the rest of your python packages.

See this issue for more information.

Then run the following commands:

# create a virtual environment to run Meltano isolated from OS-level packages
$ python -m venv venv

# install Meltano in the aforementioned virtual environment
$ pip install meltano
$ meltano --help
Usage: meltano [OPTIONS] COMMAND [ARGS]

That's it! Meltano is now be available in the virtual environment we setup. Now, we can create a Meltano project.

Docker Images

We provide the meltano/meltano docker image with Meltano preinstalled and ready to use.

Note: The meltano/meltano docker image is also available in GitLab's registry:

This image contains everything you need to get started with Meltano.

# to download or update to the latest version
$ docker pull meltano/meltano

# to look the currently installed version
$ docker run meltano/meltano --version
meltano, version …

Please refer to the docker tutorial for more details.


Getting the Latest Version

To update Meltano to the latest version, run the following command in your terminal:


Run source venv/bin/activate to leverage the meltano installed in your virtual environment (venv) if you haven't already.

pip install --upgrade meltano


Still having installation problems? Help us help you. Here is a pre-baked form to streamline us doing so.

Last Updated: 3/19/2019, 4:48:53 PM