Skip to content

Local UI to run and train LLMs and diffusion models. Supports GGUF, MLX, Qwen3.8, DeepSeek-V4.1, MiniMax-H3, Gemma 4, FLUX and more.

Keep Unsloth Studio data when using the command the NVIDIA toolkit installer prints (#15450)

Nilay59f577ecaeab
diff --git a/docker/install_nvidia_toolkit.sh b/docker/install_nvidia_toolkit.sh
index 996d68fd1f2..48506dac9f4 100755
--- a/docker/install_nvidia_toolkit.sh
+++ b/docker/install_nvidia_toolkit.sh
@@ -262,4 +262,14 @@ if ! driver_ok; then
the Unsloth images. Update the driver, reboot, then run: docker run --rm --gpus all --platform ${PLATFORM} ubuntu:24.04 nvidia-smi -L" 3
fi
say "Driver ${DRIVER} meets the ${MIN_DRIVER} minimum."
-say "Done. Run: docker run -d --gpus all -p 8000:8000 -p 8888:8888 unsloth/unsloth"
+say "Done. Start Unsloth with:"
+cat <<'EOF'
+docker run -d --name unsloth --gpus all --ipc=host \
+ --ulimit memlock=-1 --ulimit stack=67108864 \
+ -p 8000:8000 -p 8888:8888 \
+ -v "$PWD":/workspace/host \
+ -v unsloth-workspace:/workspace \
+ -v "$HOME/.cache/huggingface":/workspace/.cache/huggingface \
+ -v unsloth-studio:/opt/unsloth-studio \
+ unsloth/unsloth && docker logs -f unsloth
+EOF
diff --git a/tests/python/test_docker_hub_readme.py b/tests/python/test_docker_hub_readme.py
index c0d1ce2ca56..9e3ac66fe00 100644
--- a/tests/python/test_docker_hub_readme.py
+++ b/tests/python/test_docker_hub_readme.py
@@ -20,6 +20,7 @@ REPO_ROOT = Path(__file__).resolve().parents[2]
WORKFLOW = REPO_ROOT / ".github" / "workflows" / "docker-publish.yml"
HUB_README = REPO_ROOT / "docker" / "DOCKERHUB.md"
REPO_README = REPO_ROOT / "README.md"
+TOOLKIT_INSTALLER = REPO_ROOT / "docker" / "install_nvidia_toolkit.sh"
DEFAULT_SECRET = "not-a-secret"
@@ -114,13 +115,23 @@ def _docker_runs(text: str) -> list[list[str]]:
def test_every_studio_run_keeps_the_studio_volume():
studio_images = {"unsloth/unsloth", "unsloth/unsloth:latest", "unsloth/unsloth:studio"}
checked = 0
- for doc in (HUB_README, REPO_README):
- for argv in _docker_runs(doc.read_text(encoding = "utf-8")):
- if not studio_images.intersection(argv):
- continue
- checked += 1
+ for doc in (HUB_README, REPO_README, TOOLKIT_INSTALLER):
+ runs = [
+ argv
+ for argv in _docker_runs(doc.read_text(encoding = "utf-8"))
+ if studio_images.intersection(argv)
+ ]
+ assert runs, f"{doc.name} does not give a full docker run command for the image"
+ for argv in runs:
assert "unsloth-studio:/opt/unsloth-studio" in argv, f"{doc.name}: {' '.join(argv)}"
- assert checked >= 3
+ checked += len(runs)
+ assert checked >= 4
+
+
+def test_the_toolkit_installer_ends_with_the_hub_quick_start():
+ hub = HUB_README.read_text(encoding = "utf-8")
+ hub_run = _docker_runs(hub[hub.index("## Quick start") : hub.index("### Before that")])
+ assert _docker_runs(TOOLKIT_INSTALLER.read_text(encoding = "utf-8")) == hub_run
def _docker_sections(text: str) -> list[str]: