Downloading and installing Umple

Below are instructions for downloading and installing Umple, a model-oriented programming technology that lets you model in code. Here is more information about Umple, or try it online without downloading, using the UmpleOnline tool.

Umple can be used on Mac-OS, Windows or Linux. You have several downloading options described below, including directly downloading a jar, using homebrew, using Docker, using VSCode, or using Eclipse

To obtain the full tree with source code go to Umple's Github main page. The list of recent changes can be found by clicking here


A. Downloading Umple for Command-Line use

Prerequisite dependency: An up-to-date Java 8 JDK or higher. The compiler has been tested and is also known to work under Java versions up to Java 16. If Java is not installed, then on Ubuntu first run apt install default-jdk or on Mac run brew install openjdk or on Windows choco install openjdk .


To run the Umple compiler on the command line


B. Running UmpleOnline in your own computer's Docker installation

Requirement: Docker installed on your computer.

Umple provides a Docker image of Umpleonline that allows you to explore all the features of Umple through a web browser, with the server running locally on your computer. To use this, do the following after installing Docker. Further information can be found on Umple's Docker Hub page

You can also accomplish the above by downloading and installing our script called udock and passing it the optional argument -d {dir} for your local storage directory (otherwise data will be stored in a temporary directory)

More information about Umple in Docker can be found at

New Docker images are produced for each release of Umple, with occasional interim images. A list of Docker images can be found at the Umpleonline DockerHub site. The image tagged 'latest' will be downloaded by default.


C. Running in VSCode.

A Visual Studio Code plugin for Umple is available.


D. Installing and running the Umple compiler in Eclipse

Requirements: Java (as above), and the latest Eclipse with modeling tools.

Full directions for installing the Eclipse plugin can be found on this Umple Wiki Page.

The update site to install Umple in Eclipse is


E. The Umplificator

Another tool available is the umplificator, for reverse engineering code to Umple. The Umplificator can be downloaded here.


User Manual

Refer to the Umple user manual for comprehensive help programming in Umple. The API quick reference and grammar quick reference may be of particular help for power users.