> For the complete documentation index, see [llms.txt](https://asus-isg-aidc.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://asus-isg-aidc.gitbook.io/guide/latest/portal/overview/service-catalog/docker.md).

# Docker

| Developer | Last modified |
| --------- | ------------- |
| AIDC Team | 2026/08/21    |

## Service Introduction

**Docker Engine** is the industry-standard containerization platform that allows you to package and run applications in isolated environments.

![](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/marketplace/service-catalog-docker.png)

### Quick Summary

| Item                          | Details                                |
| ----------------------------- | -------------------------------------- |
| ⏱️ **Estimated Time**         | 5-15 minutes                           |
| 💻 **Supported Platforms**    | See the **Supported Platforms Matrix** |
| 🔧 **Minimum Nodes Required** | 1 node                                 |
| 📦 **Included Components**    | Docker Engine, Docker CLI, containerd  |

***

## Prerequisites

Before starting the deployment, ensure the following requirements are met:

### Hardware Requirements

| Role            | Minimum Spec                 | Recommended Spec              |
| --------------- | ---------------------------- | ----------------------------- |
| **Docker Host** | 2 vCPU / 4GB RAM / 20GB Disk | 4 vCPU / 8GB RAM / 100GB Disk |

### Network Requirements

* ✅ Outbound internet access for pulling images (or private registry configured)

### Other Requirements

* ✅ Nodes have been provisioned and are in **Ready** state
* ✅ Root or sudo access available

***

## Deployment Dialog Introduction

Docker Engine deployment is divided into **3 steps**:

```mermaid
flowchart LR
    Step1["Step 1: Installation Target"]
    Step2["Step 2: Container Configuration"]
    Review["Step 3: Review and Deploy"]

    Step1 --> Step2
    Step2 --> Review
```

[Step 1: Installation Target](#step-1-installation-target-selection-groupnode) | [Step 2: Container Configuration](#step-2-container-configuration) | [Step 3: Review and Deploy](#step-3-review-and-deploy)

***

### Step 1: Installation Target Selection (Group/Node)

![](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/marketplace/service-catalog-docker-step1.png)

| Parameter Name         | Type   | Description           |    Required   | Validation Rules                  | Example        |
| ---------------------- | ------ | --------------------- | :-----------: | --------------------------------- | -------------- |
| **Installation Group** | string | Installation Group ID | ⚪ Conditional | **Either Group or Node required** | `docker-hosts` |
| **Installation Node**  | string | Installation Node ID  | ⚪ Conditional | **Either Group or Node required** | `node-01`      |

{% hint style="warning" %}
**⚠️ Selection Rule**

At least one of **Group** or **Node** must be selected.\
When selecting Group, Docker will be installed on **all Nodes** in that Group.
{% endhint %}

***

### Step 2: Container Configuration

![](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/marketplace/service-catalog-docker-step2.png)

| Parameter Name      | Type   | Description                    |  Required  | Validation Rules                                  | Example        |
| ------------------- | ------ | ------------------------------ | :--------: | ------------------------------------------------- | -------------- |
| **Image**           | string | Container image name           | ⚪ Optional | **Required if containerCount is filled**          | `nginx:latest` |
| **Container Count** | number | Number of Containers to create | ⚪ Optional | **Required if image is filled; positive integer** | `3`            |

{% hint style="info" %}
**💡 Tip**

Image and Container Count must be filled together or left empty together. If left empty, only Docker Engine will be installed without creating containers.
{% endhint %}

#### Image Format Examples

```bash
# Official images
ubuntu:22.04
python:3.11-slim


```

***

### Step 3: Review and Deploy

![](https://pub-f334ff01208c4e6195b80133ac6e6030.r2.dev/portal/marketplace/service-catalog-docker-step3.png)

***

## Post-Deployment Status

After successful deployment, you can view in **Status Monitor**:

* Task status progress
* Execution status of each node
* Error logs (if any)

### Deployment Verification

After the deployment status shows **Completed**, perform the following checks:

**1. Check Docker Version**

```bash
docker --version
```

✅ **Expected Result:** show docker version

**2. Check Docker Service Status**

```bash
systemctl status docker
```

✅ **Expected Result:** Active (running)

**3. Verify Containers Running**

```bash
docker ps
```

✅ **Expected Result:** Shows running containers (if Image was specified)

***

### Manage Containers

```bash
# View all Containers
docker ps -a

# View Container logs
docker logs <container_id>

# Stop Container
docker stop <container_id>

# Remove Container
docker rm <container_id>
```

## Frequently Asked Questions

### Q: Should I choose Group or Node?

A: If you want to install Docker on multiple Nodes, choosing Group is more convenient. If you only need to install on a single Node, choose Node.

### Q: What if image pull fails?

A: Check network connectivity and verify the image name is correct. For private registries, ensure authentication is configured.

### Q: How to configure Docker to use a proxy?

A: modify `/etc/systemd/system/docker.service.d/http-proxy.conf` with proxy settings and restart Docker.

***

## Related References

* [Service Catalog](/guide/latest/portal/overview/service-catalog.md)
* [Status Monitor User Guide](/guide/latest/portal/overview/status-monitor.md#docker-status-card)
* [Docker Official Documentation](https://docs.docker.com/)