Skip to main content

Docker Installation

Deployment Flow​

Environment Preparation​

tip

For Windows environments, please install Docker Desktop and git.

Install Docker​

  • Install Docker (CentOS)

    dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
    dnf install docker-ce docker-ce-cli containerd.io
    systemctl start docker.service
    systemctl enable docker.service

  • Install Docker Compose

tip

If Docker Compose v2.9.0 fails to run, you can download v2.10.0. If you want to use a newer version of Docker Compose, please modify the docker-compose.yml file in the project accordingly.

curl -L "https://github.com/docker/compose/releases/download/v2.9.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

Alternative download link if the above is slow:

curl -L "https://get.daocloud.io/docker/compose/releases/download/v2.9.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

  • If Git is not installed

    dnf install git -y

Installation with Mirror Acceleration​

Debian System Installation Guide
CentOS System Installation Guide
Ubuntu System Installation Guide
AlmaLinux System Installation Guide

Start Installation​

  • Pull Project

    # Pull docker configuration
    git clone https://github.com/ThingsPanel/thingspanel-docker.git
    cd thingspanel-docker

  • Run Project

    In the thingspanel-docker directory (Windows users need to open a cmd window)

    # Start project in foreground (default port 8080)
    docker-compose -f docker-compose.yml up
    # Or start in background
    docker-compose -f docker-compose.yml up -d
    # Stop services
    docker-compose -f docker-compose.yml down

  • Login

Volume Mapping​

  • Configuration, Logs, and other diff files

    ./data

  • Docker Volume Names

    go
    gmqtt
    nginx

View Container Logs​

docker logs -f containerID

Port Description​

8080 (Frontend Service)
9999 (Backend API)
1883 (MQTT)
8883 (MQTTS)
5432 (PostgreSQL)
6379 (Redis)
Device Connection

For device connection instructions, please refer to: MQTT Connection