Command Line Interface (CLI)
The CLI can be used to simplify working with PIPEFORCE.
Install on Mac
If you're running a Mac, you can download and install a DMG image which contains everything out-of-the-box. Follow these steps to do so:
Download the DMG image from here: https://downloads.pipeforce.io/pipeforce-cli/
Double click it and drag & drop the pi tool into your
Open your terminal and execute this command in order to create a local workspace:
Follow the setup instructions.
Add the path to the pi workspace to the paths variable. To do so, open the
$> sudo nano /etc/paths
Add a line pointing to the pi workspace script at the end of the file and save it. The file content might finally look similar to this:
You're done. Close and re-open your terminal. Test it by running this command in the terminal:
$> pi status
This should print you the status of your
piinstallation and your server instance without any errors. You should get an output similar to this:
Install on other platforms
If you're running Windows or Linux, follow these steps in order to download and install the CLI.
Verify and install Java 8
Open your terminal and verify that you have a Java runtime version >= 1.8 installed:
$> java -version
You should see an output similar to this:
java version "1.8"
If there is a version number 1.8 or higher shown, then you have installed “Java 8” or higher.
In case you see an output like “command not found” then you probably have no Java environment installed yet. So go to the next step and download and install the environment.
If you have not Java runtime yet, follow these steps to download and install:
- Go to https://www.java.com/de/download/ and download the latest Java runtime.
- Install the downloaded package.
- Open a new console window and try out that this command now shows the installed Java version:
$> java -version
Download an install the CLI
After you have made sure that Java is installed and runs correctly, you can download the latest version of the cli tool by clicking this link:
Select the jar file with highest version number and download it to your computer.
Do not download the one with latest in the name since this is for auto-updates only.
After this, open a new terminal / command line window and change to the folder where you downloaded the file to. Usually this is the Download folder as shown in this example for Mac and could differ for your operating system:
$> cd /Users/username/Downloads
Now install the cli tool by executing this command:
> java -jar pipeforce-cli-VERSION.jar setup
VERSION by the version number of the downloaded file.
You will then be asked to install the tool. Select
Follow the wizard to install the CLI.
How to update?
To update to the lastest version, simply use this command:
It will search for latest versions and automatically download + install it for you.
The auto-update feature is only available if you have installed the Java-Version of the CLI as described in this section. It doesnt work with the Mac DMG image version.
Add it to your Windows path
Optionally you can add the pi tool to your path variable in order to simplify the call to:
To do so, add the file
pi.bat inside your
$USER_HOME/pipeforce folder to the PATH variable on your Windows system.
Add it to your Linux path
Optionally you can add the CLI tool to your path variable in order to simplify the call to:
To do so, add the folder
$USER_HOME/pipeforce to your paths file.
The BPMN modeler is a free tool to design BPMN diagrams and save the BPMN files offline. These files then can be deployed to PIPEFORCE using the
workflow.deploy command or using the online workbench.
The PIPEFORCE portal has also an online BPMN designer built-in, so an offline tool like this is optional in this case.