Quick Start¶
terrarium [options] COMMAND [requirements files...]
See terrarium --help for a complete list of options and commands.
Creating a new environment¶
The following example will create a new virtual environment named env that includes the packages defined in requirements.txt
$ terrarium --target env install requirements.txt
Replacing an existing environment¶
The following example demonstrates how terrarium can be used to replace an existing activated virtual environment with a different set of packages.
$ terrarium --target env install requirements.txt
$ source env/bin/activate
$ terrarium install other_requirements.txt
Note
The environment that was replaced is renamed to env.bak, and can be restored using terrarium revert.
Note
After installing the other_requirements, it is not necessary to run deactivate or activate to begin using the new environment.