CLASSROOM // HOMELAB ACADEMY M1 LESSON
M1 LESSONlesson

Homelab Academy / Modules

Teach it back 02-compose: Lesson

Orient, prior check, guided practice, required Feynman, reflect.

Show commands for:
Class 2: Docker Compose
Class 2 visual reference. Use it as the map, then prove it in the reading, lesson, and lab.

Overview

Module: Module 1: Infrastructure & Addressing
Activity type: Lesson (Orient → Recall → Learn → Explain → Reflect)
Learning objective: Given a multi-step docker run intent, the learner can write a Compose file with services, ports, environment, and persistent mounts, then recreate the stack without data loss.
Bloom level: Apply / Create
Mastery unlock for this topic: reading done + Feynman complete + quiz ≥80% (when scored) + lab gate + homework submitted

Objective

Learning objective

Given a multi-step docker run intent, the learner can write a Compose file with services, ports, environment, and persistent mounts, then recreate the stack without data loss.

Why it matters

Why this matters

Shell history is not a system design. If your stack only exists as remembered commands, you cannot rebuild after failure: and every later ARR/HA/voice service will be fragile.

Prior check

Prior-knowledge check

Answer briefly before reading Instruction. Wrong answers are useful: they show what to review.

  1. What is a container image versus a running container?
  2. Where should application data live if the container is deleted?
  3. Why might publishing a host port be both useful and dangerous?
Learn

Learn

Complete the module reading first:

Then review the worked example inside that reading (I do).

Practice

Guided practice (We do)

We do: hints allowed. Check your reasoning against Instruction.

Convert one documented docker run (from the lesson) into Compose YAML with assistance. Check: service name, image, ports, env, volume, restart policy.

Teach it back

Feynman teach-back: required

Required. Do not skip.

Explain

Describe why Docker Compose beats a long docker run for real systems in your own words. No copying the lesson verbatim.

Simplify

Explain the same idea to a 12-year-old. If you use a technical word, define it.

Example

Analogy: a recipe card (Compose) vs remembering a cooking performance (run commands).

Weak spot

What part was hard to explain? That is where your understanding is thin.

Retry

Return to that part of Instruction, restudy it, then rewrite a clearer explanation below.

Mastery note: a completed Feynman teach-back is required before the next class unlocks: “I get it” without explanation does not count.

Answers save in this browser (localStorage). Completing all five fields is part of the mastery unlock.

Reflect

Reflection

Where did persistence almost fail, and what evidence proves recreate is safe?

Also answer:

  1. What did I learn?
  2. What did I struggle with?
  3. How does this connect to earlier classes?
Spiral

Spiral hook

Every later class assumes Compose + persistence. Class 3 adds networks; Class 4 adds update/rollback; Classes 5–14 drop more services into the same operational model.

Learn

Topic path (do in order)

Step Activity Purpose
1 Reading Learn
2 This lesson (Feynman) Explain / understand
3 Lab Practice under guidance + break/fix
4 Homework Independent apply
5 Quiz Test / retrieval
← ReadingLab →