4. Running the FPGA AI Suite Docker* Container
After setting up the Docker* image, you can run the container.
If you have an FPGA development kit, ensure that the board is connected to power and that the UART/JTAG cables are connected to the host machine where you will run the container.
To run the FPGA AI Suite Docker* image:
- Start your Docker* client, if it is not yet started.
- Start a Windows command prompt session.
- In the command prompt session, run one of the following commands:
- If you do not have an FPGA board and want to run a software-only flow, run the following command:
docker container run --name fpga-ai-suite-2025.1 -p 22:22 -it -v C:\Users\<username>\<path-to-share>:/mnt/host alterafpga/fpgaaisuite-v2025.1:latest
- [FPGA] If you have an FPGA development kit, run the following command:
docker container run --device=/dev/ttyUSB0 --name fpga-ai-suite-2025.1 -p 22:22 -it -v C:\Users\<username>\<path-to-share>:/mnt/host alterafpga/fpgaaisuite-v2025.1:latest
When the container starts, you should see the following output:[setupvars.sh] OpenVINO environment initialized export COREDLA_VERSION=1 export COREDLA_GCC=/usr/bin/gcc export COREDLA_ROOT='/opt/altera/fpga_ai_suite_2025.1/dla'
- If you do not have an FPGA board and want to run a software-only flow, run the following command:
- [FPGA] To see the FPGA development kit in the container, run the following command:
lsusb
The FPGA development kit should appears as a UART device as indicate in bold text the following example lsusb command output:fpga-ai-suite-2025.1@3e5bd678f34e:~$ lsusb Bus 002 Device 001: ID 1d6b:0003 Bus 001 Device 002: ID 0403:6001 FTDI FT232R USB UART Bus 001 Device 001: ID 1d6b:0002
- [FPGA] Confirm that the FPGA development kit device was passed to the container in the /dev folder with the following command:
ls /dev/ttyUSB*
If the device was correctly passed to the container, the output should appear similar to the following example output:ttyUSB0