Installation

In this section, we will install Meltano as an application you can access from your browser and command line. If you prefer to install to Docker, please view the installation instructions here.

We do not have a double click installer at this time, but it is in our roadmap and we will be sure to update this page when we do!

Requirements

Before you install meltano with pip install meltano make sure you have the following requirements installed and up to date.

Python 3+

You may refer to https://realpython.com/installing-python/ for platform specific installation instructions.

To check if you have the correct Python version, open your terminal and use the following commands to check the version:

$ python --version
Python 3.6.1

pip

pip is a package installer that comes automatically with Python 3+. This is also what we will be using to install Meltano. Here are some commands related to pip that may be of interest:

# Check for current version of pip
$ pip --version

# Update pip
$ pip install --upgrade pip

TIP

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

Virtual Environment

Meltano must be installed inside a virtual environment, unless you are building a Docker image.

We suggest you create a directory where you want your virtual environments to be saved, e.g.:

  • Linux, OSX: ~/virtualenvs
  • Windows: %ALLUSERSPROFILE%\\virtualenvs

Then create a new virtual environment inside that directory:

# Linux, OSX
$ mkdir ~/virtualenvs
$ python -m venv ~/virtualenvs/meltano

# Windows
$ mkdir %ALLUSERSPROFILE%\\virtualenvs
$ python -m venv %ALLUSERSPROFILE%\\virtualenvs\\meltano

Then, you will need to activate the virtual environment using:

# Linux, OSX
$ source ~/virtualenvs/meltano/bin/activate

# Windows
$ %HOME%\\virtualenvs\\meltano\\Scripts\\activate.bat

Installing Meltano

Now that you have your virtual environment set up and running, navigate to the directory where you want to install Meltano and run the following command:

$ pip install meltano

Once the installation completes, you can check if it was successful by running:

$ meltano --version
meltano, version X.XX.X

That's it! Meltano is now be available for you to use. Now we can create a Meltano project.

TIP

Once a virtual environment is activated, it stays active until the current shell is closed.

You must re-activate the virtual environment before interacting with Meltano. To streamline this process, you can add the meltano executable directly in your PATH.

# Linux, OSX
export PATH=$PATH:$HOME/virtualenvs/meltano/bin/meltano

# Windows
setx PATH "%PATH%;%ALLUSERPROFILES\virtualenvs\meltano\Scripts\meltano"

Troubleshooting

Are you having installation problems? We are here to help you. Please fill out this issue template and we'll get back to you as soon as we can!

Upgrading Version

We release new versions of Meltano weekly. To update Meltano to the latest version, run the following command in your terminal:

$ pip install --upgrade meltano

Follow along on the Meltano blog to keep tabs on the latest releases, or visit our CHANGELOG.

Last Updated: 6/24/2019, 7:41:50 PM