wiki/content/homelab/workshops/Workshop Cheatsheet — Deploy your own ChatGPT.md

title, publish, date, tags, description

title	publish	date	tags	description
Workshop Cheatsheet — Deploy your own ChatGPT	true	2026-03-03	workshop Cheatsheet HECIA containerization docker openwebui	A cheatsheet for the "Deploy your own ChatGPT" workshop

Workshop Cheatsheet — Deploy your own ChatGPT

Commands only. Full explanations in the reference document shared at the end.

---

1 · Install Docker

Register Docker's repository

sudo apt update
sudo apt install ca-certificates curl

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Install Docker

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Type Y when prompted.

Verify

docker --version
docker compose version

✅ Both should print a version number.

---

2 · Deploy OpenWebUI

Create the project folder

mkdir -p ~/projects/openwebui
cd ~/projects/openwebui

Create compose.yaml — paste this exactly:

services:
  openwebui:
    image: ghcr.io/open-webui/open-webui:main-slim
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
    restart: unless-stopped

volumes:
  open-webui:

Start the container

docker compose up -d

First run downloads the image — wait 1–2 min.

Watch startup logs (optional)

docker compose logs -f

Press Ctrl+C to stop watching. The container keeps running.

Open in your browser

https://openwebui.<shortname>.workshop.hec-ia.com

Your shortname = first initial + last name, lowercase. e.g. John Smith → jsmith

First launch: create an account — you automatically become admin.

---

3 · Configure an API key

Settings → Admin Panel → Connections

---

Useful commands

Command	Effect
docker compose up -d	Start the app
docker compose down	Stop the app
docker compose logs -f	Watch live logs
docker compose pull	Update the image
docker ps	List running containers

Always run these from ~/projects/openwebui