Please enable JavaScript to view this site.

winIDEA Help

Version: 9.21.335

Docker

Introduction

Docker provides a powerful and flexible platform for building and deploying applications on Linux. It offers a range of benefits, including portability, isolation, efficiency, consistency, and security, which can help to streamline the development and deployment process and improve the overall quality of your applications. It is recommended to use it for multiple versions installed in parallel.

 

You can install BlueBox tools on Linux for Verified builds (monthly) and Hot fix builds (weekly). The difference between them is explained in winIDEA Release Notes.

 

Before using the Docker engine, follow the instructions from Docker to configure the system properly.

 

i-icon

Docker supports the installation of multiple versions of the package. Use the correct tag of Docker image at starting Docker.

 

 

Configuration steps

number1

Create a working directory (e.g., ${HOME}/dwinidea) and move into it.

$ mkdir ${HOME}/dwinidea
$ cd ${HOME}/dwinidea

 

 

number2

Copy the run script into this directory from the local network using scp or download it from the official website.

$ curl https://www.isystem.com/downloads/winIDEA/setup/docker-winidea > docker-winidea

 

 

number3

Set the executable permissions to run the script.

$ chmod +x ./docker-winidea

 

 

Number4

Download and import the winIDEA Docker image.

It requires sudo privileges to setup USB mapping.

 

•from the official server (latest Verified build)

$ ./docker-winidea import

 

•from the official server (Hot fix build where the argument value <version> is, e.g., 9.21.259-179304)

$ ./docker-winidea import --version=<version>

 

•from the local disk (in case when official server is not reachable from host, e.g., winidea-9.21.253-177139.amd64.tar.xz)

a.First download winIDEA Docker image and copy it to the host. Contact Technical support if you don’t know the download link.

b.Import the Docker image.

$ ./docker-winidea load-file --image=<path to image file>

 

 

Number5

Run winIDEA from Docker.

Runtime script offers several useful command arguments for customizing the runtime Docker environment (use the --help option to show them).

$ ./docker-winidea --help

 

Example output:

Usage:
 docker-winidea <command> [<options> ...]
 
 
Commands:
 import                   - import docker image with specified version from WEB archive
                            (NOTE: it will purge the existing image with the same tag)
 load-file                - import docker image from file
                            (NOTE: it will purge the existing image with the same tag)
 remove                   - remove the docker image defined by argument --version=<version>
 images                   - list installed docker images
 run                      - run winidea in docker

 
Common options:
 --help                   - show this help
 --version=<version>      - give the winidea version (four numbers, eg. 9.21.259-179304)
                            If the version is not defined the most recent installed build is used

 
load-file options:
 --image=<path>           - path to the docker image file to be imported

 
run options:
 --home=<path>            - path to home directory for docker (NOTE: DO NOT USE SPACES)
                            (using the current directory if not specified)
 --nox                    - run without presenting the GUI
 --cmd="<program>"        - path to the program with arguments to be executed in docker
 --map="s1:d1|s2:d2"      - map the source path sX from host as the destination path dX into docker
                            All path values must be given as an absolute path. Multiple mapped
                            paths are separated by | sign.

 

 

•run winIDEA with basic environment

$ ./docker-winidea run

 

•run winIDEA with customized arguments

$ ./docker-winidea run --cmd="winidea <optional args>"

 

•run winIDEA with mapping from an existing winIDEA workspace directory and custom utilities into the Docker working directory

$ ./docker-winidea run ${HOME}/workspaces/testWS:${PWD}/WS|${HOME}/my-utils:${PWD}/utils"

 

•run headless winIDEA

$ ./docker-winidea run --nox

 

•run bash and start headless winIDEA in the background from there

$ ./docker-winidea run --nox --cmd bash
$ winidea &

 

 

Copyright © 2025 TASKING