Skip to content

Part 2: Setup the working environment

Estimated reading time: 7 minutes

In this section, we thoroughly explain how to setup your working environment in order to run applications powered by InAccel Coral FPGA resource manager.


  1. InAccel (inaccel) package (CLI + Container Runtime) should be installed in your system. If you have not already installed InAccel follow the instructions provided here: Debian | RPM.


    While InAccel CLI is not a true requirement, we strongly encourage the usage of the CLI instead of directly tinkering with any associated commands. Setting up Coral without InAcccel CLI and/or InAccel Container Runtime is out of the scope of this tutorial.

  2. Docker (docker) installation that fully supports custom runtimes is required for running Coral which is shipped as a container image. If you are planning to use InAccel CLI only for bitstream deployment (to any remote repository), then you can skip Docker package installation in that machine.

Verify installation-

Before you proceed, ensure that you have successfully installed inaccel by running inaccel --version:

$ inaccel --version
inaccel version 1.6.1

If your terminal's output is similar or identical to the output above then you can assume that inaccel is properly installed and continue with generating your free license key.

Generate a license-

In order to launch Coral, you need a valid license key issued by InAccel. This can be easily achieved through the following steps:

  1. Follow this link and complete the form to make an inquiry for a free license. Then, click on button CREATE NEW LICENSE and you will receive an email by InAccel containing th Community Edition license key you requested.

  2. Retrieve the license key attached to your email and store it in your local InAccel settings to use it every time you launch Coral (the settings file can be found below the ~/.inaccel directory). Simply issue the following commmand:

    $ inaccel config license CORAL_LICENSE_KEY

Launch InAccel Coral-

If you completed the above steps, then you are ready to launch Coral. To make things clear, Coral is not required to be launched neither at installation nor at bitstream deployment stage. Its functionality is to manage accelerators, hence you only need a running instance when your applications are running.

Nevertheless, we suggest to launch Coral now to complete your environment setup. If you wish, feel free to skip this section and come back before moving to Part 4.


If you are launching InAccel Coral for the first time make sure you restart docker daemon service by issuing systemctl docker restart to enable InAccel container runtime (inaccel-runc).

  1. Start Coral through its associated CLI command.

    $ inaccel coral start
    Using InAccel Coral:
    latest: Pulling from inaccel/coral
    72d97abdfae3: Pull complete
    c30834c4dd91: Pull complete
    0b5874eabc75: Pull complete
    3aa13c356d65: Pull complete
    Digest: sha256:d1cf38c619190a90aef4b3a3492f7a41048dd880661d6a2f044bd898b2142d55
    Status: Downloaded newer image for inaccel/coral:latest
  2. Verify Coral is successfuly launched by issuing inaccel coral console.

    $ inaccel coral console
    21 Coral FPGA Resource Manager
    Welcome to
      __|   _      __|  _` |  |
     (     (   |  |    (   |  | community
     ___|  ___/  _|    __,_| _| version 1.6
                     by InAccel

Congratulations, you have successfully completed your InAccel environment setup. In Part 3, we get our hands dirty by demonstrating how to package and deploy your accelerators.