Welcome to the FlexVertex Iron Edition installation guide. This guide walks you through installing Docker and running FlexVertex using Docker containers.
To run FlexVertex Iron Edition, you must have Docker installed and running. Follow the instructions below for your operating system:
Windows:
Download Docker Desktop from Docker for Windows.
Follow the provided installation and launch steps.
macOS:
Download Docker Desktop for Mac from Docker for Mac.
Follow the provided installation and launch steps.
Linux:
Follow the platform-specific Docker installation and launch instructions for:
To verify your Docker installation, run:
docker version
You should see a version number displayed.
To verify that Docker is running, run:
docker info
You should see details about your running environment.
Open a terminal and create a working directory for FlexVertex:
mkdir flexvertex
Launch a browser, and navigate to Docker Hub to identify the correct version to pull:
https://hub.docker.com/r/flexvertex/datamultiverse-iron/tags
Using your terminal, download the appropriate FlexVertex Iron Edition Docker image. Note that the version number may change from what's shown here:
docker pull flexvertex/datamultiverse-iron:1.3.0
Depending on your permissions, you may need to prefix this command with sudo
This initial docker run command sets the stage for your FlexVertex Iron Edition. It prepares the environment: setting directories, copying executables, and creating configurations. It then launches the Iron Edition.
In your terminal, enter the following:
docker run --rm -it --name flexvertex \
-p 4000:4000 -p 8000:8000 -p 8080:8080 -p 10000:10000 \
--user $(id -u):$(id -g) \
-e PASSWORD=your_chosen_administrative_password -v ~/flexvertex:/flexvertex \
flexvertex/datamultiverse-iron:1.3.0
On Linux or macOS, you can use --user $(id -u):$(id -g) to ensure the correct user permissions.
-e PASSWORD sets the administrative password you'll use for this instance.
Note that depending on your permissions, you may need to prefix docker run with sudo.
Using Windows Subsystem for Linux 2 (WSL2)
In your terminal, enter the following:
docker run --rm -it --name flexvertex \
-p 8000:8000 -p 8080:8080 -p 10000:10000 \
-v ~/flexvertex:/flexvertex \
-e PASSWORD=your_chosen_administrative_password \
flexvertex/datamultiverse-iron:1.3.0
When this step completes, you'll see output similar to:
================================
== FlexVertex Data Multiverse ==
================================
Version: 1.3.0
FlexClassWalker.walkJarFile(/opt/flexvertex/fvc/bin/FlexVertexController-1.3.0.jar)
== FlexVertex Iron Edition ==
==============================
Registered To: Iron Developer
Start Date: 2025-09-05
Valid For: 365 Days
Edition: Iron
Instance Count: 1
==============================
Your FlexVertex Iron Edition is now running and ready to use.
If you reboot or otherwise stop FlexVertex, you can follow the steps in the next section to start/stop it on an ongoing basis.
You have two options when starting FlexVertex: interactive or daemon mode.
In Docker, interactive mode (-it) allows users to actively interact with the running container through a terminal, making it useful for debugging, testing, or running commands manually. Daemon mode (-d), on the other hand, runs the container in the background, making it ideal for long-running services that don’t require direct user interaction.
For the FlexVertex service, daemon mode (-d) is typically preferred, as it enables the service to run continuously in the background without requiring an active terminal session. However, interactive mode (-it) can be useful for troubleshooting or manually inspecting the service during setup and debugging.
docker run --rm -it --name flexvertex \
-p 8000:8000 -p 8080:8080 -p 10000:10000 \
--user $(id -u):$(id -g) \
-v ~/flexvertex:/flexvertex \
flexvertex/datamultiverse-iron:1.3.0
Ctrl-C (or Cmd-C on macOS) to stop the interactive container.docker run -d --name flexvertex \
-p 8000:8000 -p 8080:8080 -p 10000:10000 \
--user $(id -u):$(id -g) \
-v ~/flexvertex:/flexvertex \
flexvertex/datamultiverse-iron:1.3.0
docker stop flexvertex.Note that depending on your permissions, you may need to prefix these commands with sudo.
With FlexVertex running, open a browser and connect to the service as follows:
http://localhost:8080
You should see a FlexVertex Commander login screen.
To connect to the sample database, enter the following username and password:
marco@flexvertex.comPoloTo connect as the administrator, enter the following username and password:
/System/System/System/Adminyour_chosen_administrative_passwordNote that you're free to set up SSL certificates based on your enterprise's policies and infrastructure.
Refer to the table below for useful Docker commands:
| Command | Description |
|---|---|
--rm |
Automatically removes the container when it exits. |
-it |
Creates an interactive container with a pseudo-TTY. |
-d |
Runs the container in daemonized mode (background). |
-p |
Maps a host-side port to an internal container port. |
--user |
Executes the container processes as the specified user. |
-v |
Creates a volume to map a host directory to an internal container directory. |
Congratulations! FlexVertex Iron Edition is now up and running. You can establish connections via any of these alternatives:
See docs.flexvertex.com for more information on these choices.
Questions? Ideas? Need help?
Join the FlexVertex Community on Discord — our developer lounge for:
Explore code examples on GitLab to see working demos and jumpstart your own projects.