Skip to content

INSTALL-TROUBLESHOOTING.md

Latest commit

 

History

History
91 lines (66 loc) · 2.68 KB

INSTALL-TROUBLESHOOTING.md

File metadata and controls

91 lines (66 loc) · 2.68 KB

Dream Server Installation Troubleshooting Guide

This guide provides solutions for common issues encountered during the installation of Dream Server.

For Linux, run ./scripts/linux-install-preflight.sh (or ./dream-preflight.sh --install-env) for a structured report with stable check IDs; see LINUX-TROUBLESHOOTING-GUIDE.md for ID-by-ID fixes.

Docker Issues

Problem: Docker Not Installed

Solution: Install Docker by following the official Docker installation guide.

Problem: Docker Service Not Running

Solution: Start the Docker service.

sudo systemctl start docker

Problem: Permission Denied When Running Docker Commands

Solution: Add your user to the Docker group.

sudo usermod -aG docker $USER

Then, log out and back in to apply the changes.

GPU Detection Issues

Problem: GPU Not Detected

Solution: Ensure that the NVIDIA drivers are installed and that the NVIDIA Container Toolkit is set up correctly.

Install NVIDIA Drivers:

sudo apt-get install nvidia-driver-<version>

Install NVIDIA Container Toolkit:

distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
curl -s -L https://nvidia.github.io/libnvidia-container/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit
sudo systemctl restart docker

Verify GPU detection:

docker run --rm --gpus all nvidia/cuda:11.0-base nvidia-smi

Port Conflicts

Problem: Port Already in Use

Solution: Identify and stop the process using the port.

Find the process ID (PID) using the port:

sudo lsof -i :<port_number>

Stop the process:

sudo kill -9 <PID>

Model Download Failures

Problem: Model Download Fails Due to Network Issues

Solution: Ensure a stable internet connection and retry the download.

Problem: Insufficient Disk Space

Solution: Free up disk space and retry the download.

Check disk usage:

df -h

Health Check Timeouts

Problem: Health Checks Fail Due to Timeout

Solution: Increase the timeout settings or check the server's health manually.

Increase timeout settings in the compose file (e.g., docker-compose.base.yml).

Check server health:

curl http://localhost:<port>/health