Quartz sync: Mar 3, 2026, 10:47 PM

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

@@ -0,0 +1,133 @@
+---
+title: Workshop Cheatsheet — Deploy your own ChatGPT
+publish: true
+date: 2026-03-03
+tags:
+  - workshop
+  - Cheatsheet
+  - HECIA
+  - containerization
+  - docker
+  - openwebui
+description: 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**
+
+```bash
+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**
+
+```bash
+sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+```
+
+> Type `Y` when prompted.
+
+**Verify**
+
+```bash
+docker --version
+docker compose version
+```
+
+✅ Both should print a version number.
+
+---
+
+## 2 · Deploy OpenWebUI
+
+**Create the project folder**
+
+```bash
+mkdir -p ~/projects/openwebui
+cd ~/projects/openwebui
+```
+
+**Create `compose.yaml`** — paste this exactly:
+
+```yaml
+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**
+
+```bash
+docker compose up -d
+```
+
+> First run downloads the image — wait 1–2 min.
+
+**Watch startup logs** _(optional)_
+
+```bash
+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**
+
+<!-- TODO: add API provider details -->
+
+---
+
+## 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`