Using Xilinx Open Source FPGA Toolchain on Docker Containers

Carlos Eduardo
5 min readApr 23, 2021

In this post I’ll explore a bit the Open Source toolchain for Xilinx Series 7 FPGAs and will focus the Artix 7. The post will detail how to run the complete flow using Docker containers avoiding local toolchain installs and homogenizing the process for most platforms (Linux, Mac, Windows).

Open source toolchain ecosystem (

As seen above, the architecture and dependency is not a walk in the park but abstracting them with straightforward tools like FuseSoc, Edalize and containers makes things a bit easier.

Installing the pre-requisites

Unfortunately not everything is in containers or work on them and you need to install some pre-requisites on your computer for this.

First Docker on Linux or Docker Desktop on your Mac or Windows. This is the runtime that runs the containers. If using Windows I recommend using WSL2 as it makes things easier providing the command line tools.

Second, you need a local Python 3 install to run FuseSoc. It can be downloaded from

Finally the programming tool that can transfer the bitstream to your FPGA. This task is…



Carlos Eduardo

Writing everything cloud and all the tech behind it. If you like my projects and would like to support me, check my Patreon on