CB-Spider Quickstart on Docker Desktop (macOS)

• CB-Spider may bind to 127.0.0.1:1024 inside the container, so it cannot be reachable from the host.
• Docker Desktop (macOS) does not support --network host.
• This Guide makes CB-Spider accessible from your host Mac at http://localhost:1024

⚠️ You must pass -e SPIDER_USERNAME and -e SPIDER_PASSWORD for the server to start.
Change the default password before deploying to production!

[Contents]

• Use Docker CLI
• Use Docker Compose

---

Use Docker CLI

1. Start CB-Spider

docker run -d --name cb-spider \
  -p 1024:1024 \
  -v ${HOME}/cloud-barista/cb-spider/meta_db:/root/go/src/github.com/cloud-barista/cb-spider/meta_db \
  -e SPIDER_USERNAME="admin" -e SPIDER_PASSWORD="your-password" \
  cloudbaristaorg/cb-spider:latest

2. Add a socat sidecar (shares the same network namespace)

• Purpose: Make CB-Spider accessible from your host Mac without changing its configuration.

docker run -d --name cb-spider-proxy \
  --network container:cb-spider \
  alpine sh -lc '
    apk add --no-cache socat >/dev/null &&
    IP=$(hostname -i) &&
    exec socat -dd TCP-LISTEN:1024,bind=${IP},fork TCP:127.0.0.1:1024
  '

3. Open AdminWeb (login required)

open http://localhost:1024/spider/adminweb          # macOS

4. Clean up

docker rm -f cb-spider-proxy cb-spider

---

Use Docker Compose

1. Create docker-compose.yaml

version: "3.8"

services:
  cb-spider:
    image: cloudbaristaorg/cb-spider:latest
    container_name: cb-spider
    ports:
      - "1024:1024"
    volumes:
      - ${HOME}/cloud-barista/cb-spider/meta_db:/root/go/src/github.com/cloud-barista/cb-spider/meta_db
    environment:
      - SPIDER_USERNAME=admin
      - SPIDER_PASSWORD=your-password
    restart: unless-stopped

  cb-spider-proxy:
    image: alpine:3.20
    container_name: cb-spider-proxy
    network_mode: "container:cb-spider"
    depends_on:
      - cb-spider
    restart: unless-stopped
    command: >
      sh -c '
        apk add --no-cache socat >/dev/null &&
        sleep 5 &&
        IP=$$(hostname -i) &&
        echo "Container IP: $$IP" &&
        exec socat -dd TCP-LISTEN:1024,bind=$$IP,fork TCP:127.0.0.1:1024
      '

Change SPIDER_USERNAME and SPIDER_PASSWORD values above before deploying to production.

2. Start CB-Spider + proxy sidecar (socat)

docker compose up -d

3. Open AdminWeb (login required)

open http://localhost:1024/spider/adminweb          # macOS

4. Clean up

docker compose down

---