Skip to end of metadata
Go to start of metadata

The Regional Controller may run on any host machine with the following requirements:

  • a relatively recent version of Docker

  • high speed networking connectivity to the Edgesites that will be deployed

  • access to the Internet for downloading Blueprints, Docker images, etc.

There is one shell script,, that may be downloaded and run to start the RC. This script takes no command line parameters; some internal values may be changed by setting and exporting certain environment variables. 

To start the Regional Controller, clone the scripts from gerrit, and then run this script as follows:

$ git clone
$ cd api-server/scripts 
$ ./ 

The operation of the start script may be modified by setting and exporting any of the following environment variables (you do so at your own risk):

VariableDefault ValuePurpose



The root of the directory tree for volumes shared with the containers.



The domain under which all these containers run.



The prefix used when naming the Docker containers.



The password used for the databases.



The name of the Docker network that all containers run on.



Alternate directory to pass to NGiNX for the SSL certificates.


The Docker image used for the API server.


The Docker image used for the Apache Airflow workflow engine.



The Docker image used for the database.



The Docker image used for the LDAP server.

The copy of NGiNX internal to the Regional Controller will only allow HTTPS (port 443) access. It comes with some built in SSL certificates, that are self-signed and are for the domain arc.akraino.demo. These are intended for demo use only; you will probably want to get your own certificates. To replace the default certificates, set the $CERTDIR variable to the directory containing your certificates. These MUST be named akraino.crt and akraino.key.

Internal Structure of the Regional Controller

The regional controller consists internally of ten docker containers.  The following diagram shows the internal flow of communication.

Internal Structure of the RC

  • No labels