Linux Installation Instructions
As of version 0.3.1, an URBANopt™ installer (Ubuntu 18.04) is available to install the URBANopt CLI, Ruby, and OpenStudio SDK at the same time. If you’d rather install the dependencies manually, view the manual install section below.
For CLI usage examples, see our Getting Started page
Install with the URBANopt Installer
Download the desired version of the .deb package.
This will install to
To run the UrbanOpt CLI, first run the
setup-env.shscript that generates environmental variables and stores these in
env_uo.shin your home directory.
/usr/local/urbanopt-cli-X.X.X/setup-env.sh . ~/.env_uo.sh
- When launching new shell terminals, run
. ~/.env_uo.shto setup the environment.
Linux installation has not been tested exhaustively. Please submit a bug report via the Github issue page if you run into installation errors
- Install Ruby 2.7 (anything in the 2.7.x range will work). We recommend using rbenv to manage and install Ruby 2.7
- Install rbenv on your system
- Install your desired Ruby version
- Do not forget the
rbenv initstep of rbenv installation
- Once installed, you may check which versions of Ruby have been installed and which one is active with:
- Set your current directory to use Ruby 2.7.x with:
rbenv local 2.7.x
- Full documentation for rbenv can be found at the rbenv github site
Install Bundler version 2.1:
gem install bundler -v 2.1
Install OpenStudio 3.4.0
OpenStudio is designed to be used on Ubuntu 18.04. For other Ubuntu versions, see the troubleshooting page.
RUBYLIBenvironment variable path pointing to OpenStudio Ruby location by pasting the following line into your
.zshenvor similar file:
(where X.X.X is the OpenStudio version installed)
Install the URBANopt Command Line Interface (CLI):
gem install urbanopt-cli
URBANopt CLI Usage
View available CLI commands with:
For detailed instructions, see the Getting Started page.
URBANopt Python Dependencies
As of version 0.9.0, the URBANopt CLI has integrated 3 python workflows: OpenDSS, DES, and DISCO. To install these python dependencies, a new URBANopt CLI command has been created. The following command will install python and pip as well as the python packages urbanopt-ditto-reader, geojson-modelica-translator, and nrel-disco.
The python installation path will be printed in the terminal once python is successfully installed; you may want to save this path for use in future troubleshooting.
As of version 0.5.2, the URBANopt CLI includes DES support. This functionality is implemented in Python and Modelica requires that various dependencies be installed before use.
While the GeoJSON Modelica Translator will be installed automatically with the UO CLI
install_python command, follow the DES Installation Instructions to install additional dependencies related to this workflow.