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!
Before you install meltano with
pip install meltano make sure you have the following requirements installed and up to date.
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 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
python is not working, try
python3 instead. This would be the case if you have both Python 2+ and 3+ installed.
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.:
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
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.
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
# Linux, OSX export PATH=$PATH:$HOME/virtualenvs/meltano/bin/meltano # Windows setx PATH "%PATH%;%ALLUSERPROFILES\virtualenvs\meltano\Scripts\meltano"
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!
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