Skip to content

TROUBLESHOOTING.md

Latest commit

 

History

History
44 lines (28 loc) · 2.29 KB

TROUBLESHOOTING.md

File metadata and controls

44 lines (28 loc) · 2.29 KB
Raw

image.png# Troubleshooting

Local URL not accessible when running on a remote server

mindos start prints two URLs on startup:

- Local:    http://localhost:3002
- Network:  http://<server-ip>:3002

Problem: Clicking the Local URL opens nothing when you're connected via SSH.

Cause: localhost refers to the server's own loopback interface. When you access it from your local machine, it resolves to your machine's localhost — not the server's.

Solutions:

  1. Use the Network URL — requires the port to be open in the server's firewall.

  2. SSH port forwarding (recommended — no need to expose the port publicly):

    ssh -L 3002:localhost:3002 user@<server-ip>

    Then open http://localhost:3002 in your local browser.

Docker: Cannot connect to the Docker daemon

The client is installed but no daemon is listening on /var/run/docker.sock (service not running, or you lack permission).

  1. Start Docker (Linux): sudo systemctl start docker then sudo systemctl enable docker.
  2. Permission: add your user to the docker group, then re-login: sudo usermod -aG docker "$USER".
  3. Not installed: use your distro’s package (docker.io on Debian/Ubuntu, docker-ce from Docker’s docs) or your cloud’s “容器服务”文档.

BuildKit / buildx (optional): sudo apt install docker-buildx-plugin (Debian/Ubuntu) or set export DOCKER_BUILDKIT=1 when building.

See also DOCKER.md in the repo root.

Docker: unknown flag: --rm when running docker compose run --rm …

Usually docker compose is not available (Compose V2 plugin not installed), so the CLI does not enter the compose subcommand and --rm is parsed as a top-level docker flag (invalid).

  1. Install the plugin: sudo apt install docker-compose-plugin (Debian/Ubuntu) or sudo dnf install docker-compose-plugin / sudo yum install docker-compose-plugin (Fedora/RHEL-style — no apt on these). If the package is missing, follow Docker Engine install for your distro.
  2. Verify: docker compose version.
  3. Run onboard without --rm: docker compose run mindos mindos onboard, or use standalone docker-compose run --rm … if you only have the v1 binary.