---
title: Install SHAPE with Docker
description: Set up SHAPE with Docker and prepare your environment for robotics and IoT development. This guide walks you through the installation and initial configuration, helping you get ready for your first project.
url: "https://thetactigon.com/docs/install-shape-docker/"
updated: "2026-10-27"
category: Getting started
---

# Install SHAPE with Docker

Install Tactigon SHAPE with Docker on Ubuntu and prepare your workspace for robotics and IoT development. This guide covers system requirements, installation steps and how to open the visual programming interface.

## System requirements

Before you begin, make sure your computer meets the following requirements:

| Component | Requirement |
| --- | --- |
| Operating system | Ubuntu 24.04 |
| Processor | CPU with AVX/FMA support |
| Memory | 8 GB RAM |
| Storage | 32 GB disk space |
| Software | Docker installed |

**Planning to use Tactigon SKIN?** You will also need Bluetooth Low Energy 5.0 or later. Bluetooth 5.3 is recommended.

For installation on Windows through Windows Subsystem for Linux, follow the dedicated WSL configuration instructions before continuing.

## 1. Download Tactigon SHAPE

Open a terminal and clone the official GitHub repository:

```
git clone https://github.com/TactigonTeam/Tactigon-Shape.git
```

Enter the project directory:

```
cd Tactigon-Shape
```

This directory contains the files needed to configure and launch SHAPE.

## 2. Configure your environment

Move the `.xprofile` file included in the repository to your home directory:

```
mv .xprofile ~/
```

> **Before running this command:** if your home directory already contains a `.xprofile` file, back it up. Moving the supplied file may replace your existing configuration.

## 3. Start SHAPE with Docker

From the project directory containing `docker-compose.yml`, run:

```
bash start.sh
```

Wait for the startup process to complete. Keep the terminal open so you can check its output during this step.

![Terminal command to start Tactigon SHAPE with Docker: bash start.sh.](https://thetactigon.com/wp-content/uploads/2026/10/Terminale-Ubuntu-con-comando-bash-1024x1024.png)

## 4. Open the SHAPE interface

Tactigon SHAPE is configured to start automatically in your Docker environment.

On the computer running SHAPE, open your browser and visit:

```
http://0.0.0.0:5123
```

You should now see the SHAPE interface, where you can access example projects and begin working with visual programming blocks.

![Tactigon SHAPE interface with example projects and visual programming blocks.](https://thetactigon.com/wp-content/uploads/2026/10/tactigon-shape-interface.png)

## Next steps: create your first Shape

With the interface open, you are ready to build your first project.

Continue to **Create your first Shape** to learn how to add a project, connect blocks, save your work and run it.

### Connect Tactigon SKIN

If you are using Tactigon SKIN for gesture interaction, continue to **Connect Tactigon SKIN**. The guide explains how to find your device, select the hand on which you will wear it and check its battery level.

## Source and technical documentation

For the source code and additional technical instructions, visit the [Tactigon SHAPE GitHub repository](https://github.com/TactigonTeam/Tactigon-Shape?utm_source=chatgpt.com) and the [installation documentation](https://github.com/TactigonTeam/Tactigon-Shape/wiki/Prerequisites-and-installing?utm_source=chatgpt.com).