---
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`