https://github.com/dockersamples/labspace-compose-quickstart
https://github.com/dockersamples/labspace-compose-quickstart
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dockersamples/labspace-compose-quickstart
- Owner: dockersamples
- License: apache-2.0
- Created: 2026-03-03T20:26:08.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-02T19:45:39.000Z (3 months ago)
- Last Synced: 2026-04-03T06:42:53.541Z (3 months ago)
- Language: Python
- Size: 28.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-labspaces - Getting started with Docker Compose
README
# Labspace - Compose Quickstart
An interactive lab that teaches Docker Compose fundamentals by building a multi-container Python Flask and Redis application from scratch. Learners progress from a bare `compose.yaml` through health checks, live development with watch mode, data persistence with volumes, and multi-file Compose configurations.
## Learning objectives
This Labspace will teach you the following:
- Define a multi-service app in a `compose.yaml` file
- Control startup order with health checks and `depends_on`
- Iterate on code quickly using watch mode
- Persist data across container restarts with named volumes
- Compose multi-file configurations with the `include` directive
- Use core debugging commands (`config`, `logs`, `exec`)
## Launch the Labspace
To launch the Labspace, run the following command:
```bash
docker compose -f oci://dockersamples/labspace-compose-quickstart up -d
```
And then open your browser to http://localhost:3030.
### Using the Docker Desktop extension
If you have the Labspace extension installed (`docker extension install dockersamples/labspace-extension` if not), you can also [click this link](https://open.docker.com/dashboard/extension-tab?extensionId=dockersamples/labspace-extension&location=dockersamples/labspace-compose-quickstart&title=Compose%20Quickstart) to launch the Labspace.
## Contributing
If you find something wrong or something that needs to be updated, feel free to submit a PR. If you want to make a larger change, feel free to fork the repo into your own repository.
**Important note:** If you fork it, you will need to update the GHA workflow to point to your own Hub repo.
1. Clone this repo
2. Start the Labspace in content development mode:
```bash
# On Mac/Linux
CONTENT_PATH=$PWD docker compose up --watch
# On Windows with PowerShell
$Env:CONTENT_PATH = (Get-Location).Path; docker compose up --watch
```
3. Open the Labspace at http://dockerlabs.xyz.
4. Make the necessary changes and validate they appear as you expect in the Labspace
Be sure to check out the [docs](https://github.com/dockersamples/labspace-infra/tree/main/docs) for additional information and guidelines.