Discover the new mydSPACE services: License Management, the new dSPACE Help, and dSPACE Chatbot for User Documentation. Find more information and support on our dedicated support page. Learn more & get support

FAQ 398: Quick Guide on VEOS Containerization

Question

How can I build a VEOS Docker and run a simulation on a local machine or on cloud (AWS)? 

Solution

Prerequisites:

  • Docker installed and running
  • Python installed.
  • A valid license hosted on AWS (recommended)

Preparation:

  • Download the required files from the dSPACE website: dSPACE Products for Linux - dSPACE
  • dSPACE Release used for the guide: 2025-B
  • Download the following files from: VEOS 2025-B Linux Download - dSPACE
    • Installation package file for VEOS 2025-B: dspace-veos-2025b_jammy_p3.tar.gz
    • Example package for the build and run scripts:
      dspace-veos-2025b-docker-example.tar.gz
  • Copy both files to a common directory
  • Extract dspace-veos-2025b-docker-example.tar.gz
    with the following command: tar -xvf dspace-veos-2025b-docker-example.tar.gz

Procedure:

Navigate to the directory where dspace-veos-2025b-docker-example.tar.gz was extracted and open a command window.

1. Check for Docker installation:

docker ps

2. Build the VEOS Docker image (Windows + Docker):
python BuildVeos.py online acceptDspaceEula <veos_docker_image>
<veos_package_file> --dockerBuildArgs "--no-cache --build-arg
<arg_name>=<value> --target veos_adaptive"

Note:

<veos_docker_image> refers to the Docker image created with BuildVeos.py.

<veos_package_file> refers to the VEOS 2025-B installation package file.

 

3. To Run the VEOS container in a Windows + Docker environment:
  1. Check for any running containers: docker ps

  2. Start the VEOS container by executing the RunVeos.py script (OSA folder mapped to the container):
python RunVeos.py <veos_docker_image> <license_server_ip> --
veosDockerContainer <container_name> --startCtun yes --dockerRunArgs "-v 
<host_path>:<container_path>"

Note: The OSA file must be built for the Linux run time. OSA files build for Windows do not work in the Docker container.

4. To run the VEOS container in AWS:
  1. Push the Docker image to AWS ECR
  2. Pull the image on the EC2 instance
  3. Copy or mount the OSA file (S3 or local storage)
  4. Run the VEOS container using Docker run:
docker run -d \
--name <container_name> \
--shm-size=<shared_memory_size> \
-p <host_port1>:<container_port1> \
-p <host_port2>:<container_port2>/<protocol> \
-e <environment_variable>=<value> \
-v <host_path>:<container_path> \
<veos_docker_image>
5. To access the container, open a new CMD window and run:

docker exec -it <container_name> bash

6. VEOS Simulation Commands:
  1. To connect to the simulator: veos sim up
  2. To check simulator information: veos sim info
  3. To verify OSA: ls /<container_path>
  4. To load OSA: veos sim load /<container_path>/<osa_file.osa>
  5. To start simulation: veos sim start
  6. To verify simulation: veos sim info
Product versions used in this solution

VEOS 2025-B

VEOS 2025-B Linux

Tags

Date 2026-09-30
Product VEOS
Information Type Frequently Asked Questions
Information Category Getting Started, Working with, Functional Extensions
Keywords SIL Support Central

Stay up-to-date with our dSPACE direct newsletter service.

With our dSPACE newsletter service, we will keep you informed about current use cases and new solutions and products, as well as trainings and events. Sign up here for a free subscription.

Enable form call

At this point, an input form from Click Dimensions is integrated. This enables us to process your newsletter subscription. The form is currently hidden due to your privacy settings for our website.

External input form

By activating the input form, you consent to personal data being transmitted to Click Dimensions within the EU, in the USA, Canada or Australia. More on this in our privacy policy.