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
- Installation package file for VEOS 2025-B:
- 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:
-
Check for any running containers:
docker ps - 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:
- Push the Docker image to AWS ECR
- Pull the image on the EC2 instance
- Copy or mount the OSA file (S3 or local storage)
- 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:
- To connect to the simulator:
veos sim up - To check simulator information:
veos sim info - To verify OSA:
ls /<container_path> - To load OSA:
veos sim load /<container_path>/<osa_file.osa> - To start simulation:
veos sim start - 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 |