Skip to main content


The Run mode of a project is where you can take your generated code for a spin. Tangram Pro™ uses the Dockerfile you provide when configuring your build to create a container image and push that image to the Tangram Pro™ container registry. During a Run, Tangram Pro™ uses those images to run containers and display your container's execution via system logs, so that you can quickly and effortlessly watch your code in action.

Run a Build

  1. Open a project that has a completed and containerized build
  2. Select Run in the top left menu
  3. Select a completed build
  4. Click the Run button

If you are already viewing a completed containerized build, then simply click its Run button.


View Previous Runs

You can access all of your previous runs at any time by clicking Runs button on the top right.

Run Docker Compose Locally

You can use Docker to test the generated interface code. We'll generate a docker-compose.yml file when you enable the Containerize option in Build configuration. Using this file and automatically generated test code, you can run an end-to-end test to do the following:

  • Create a test message using random data
  • Serialize the message (encoded to a specific format in binary)
  • Send the data via the message transport (like ZeroMQ)
  • Deserialize the data back into a message
  • Display logs in your terminal

To spin up the Docker containers on your machine

  1. Download the docker-compose.yml file
  2. Install Docker -
  3. Start Docker
  4. Create an API Key for your Tangram User
    1. Click on your profile icon in the top right and go to Account
    2. Scroll to the bottom and click Create API Key
    3. Enter a name and select Registry Scope
    4. Click Create API Key
    5. Copy the docker login ... command
  5. Open Terminal
  6. Enter the docker login ... command that you copied earlier
  7. Change directory to where you downloaded the docker-compose.yml file, like cd Downloads
  8. Enter command docker compose up
  9. If you are on a newer version of docker compose, enter command docker compose up -d && docker compose logs --follow to print logs to the terminal