alterafpga/quartus-pro repository overview

⁠Overview

This is a series of container images for Altera Quartus Prime Pro
All images provided are built on top of Ubuntu 24.04

Usage Examples:

• all: run the full compile flow for a device family support for Quartus 26.1.
  docker pull alterafpga/quartus-pro:26.1-all
• agilex3: run the full compile flow for an Agilex3 design.
  docker pull alterafpga/quartus-pro:26.1-agilex3
• agilex5: run the full compile flow for an Agilex5 design.
  docker pull alterafpga/quartus-pro:26.1-agilex5
• agilex7: run the full compile flow for an Agilex7 design.
  docker pull alterafpga/quartus-pro:26.1-agilex7

⁠Running using docker run

The images are built using rebaseable layers. The quartus base layer is shared between all images. Downloading all images will not cause multiple copies of Quartus (or any other shareable components like agilex_common) to exist in the destination.

Any of the Quartus Prime Pro command-line executables can be used with the containers. Just add the executable name and its argument after the image name on the docker run command.

A few docker run arguments are required to run the images.

⁠Required (docker run options required by all flows)

• --net=host
  This is required by the Quartus licensing. The run will fail without it.
• --mount type=bind,source=<local path to Quartus design>,target=<path inside container>
  Design needs to be mounted inside the container. By default the Quartus images use /data as the target
• --env LM_LICENSE_FILE
  Your current environment must have LM_LICENSE_FILE defined pointing to your Quartus license

⁠Examples on how to run the containers

⁠Running a Tcl script using quartus_sh for an Agilex7 project

• To run a script called run.tcl located in /quartus/project1 with the arguments val1 val2 and using the alterafpga/quartus-pro:26.1-agilex7 image use:
  
• The container will default to / as the working directory. The full pathname to the Tcl script within the container, must be provided.
  

docker run \
    --net=host \
    --env LM_LICENSE_FILE \
    --mount type=bind,source=/quartus/project1,target=/data \
    alterafpga/quartus-pro:26.1-agilex7 \
    quartus_sh -t /data/run.tcl val val2

⁠Executing a full Quartus compile using quartus_sh and a .qsf file using Agilex5

• To run a project called top located in /quartus/project1 using the alterafpga/quartus-pro:26.1-agilex5 image use:
  
• The container will default to / as the working directory. The full pathname to the Quartus project (top.qsf) within the container, must be provided.
  

docker run \
    --net=host \
    --env LM_LICENSE_FILE \
    --mount type=bind,source=/quartus/project1,target=/data  \
    alterafpga/quartus-pro:26.1-agilex5 \
    quartus_sh --flow compile /data/top

⁠Getting additional information

You can refer to the official Quartus Prime Pro documentation at:

• Quartus Prime Documentation⁠

You can also use the help command for any Quartus executables

• To get the help message for quartus_sh use:

docker run \
    --net=host \
    --env LM_LICENSE_FILE \
    --mount type=bind,source=/quartus/project1,target=/data  \
    alterafpga/quartus-pro:26.1-agilex5 \
    quartus_sh -h