Demo Docker Image
Every published release (release candidates included) gets a ready-to-run demo image: the shop, installed with demo data, plus its database in one container. It’s the quickest way to try O3-Shop: one command, no web server, PHP or database setup.
Warning
For demos only, not for production. The database runs inside the container and starts from the original demo state every time a new container is created.
Start the demo
docker run --rm -p 8080:80 ghcr.io/o3-shop/o3-shop-demo:v1.7.3
Shop: http://localhost:8080
Admin: http://localhost:8080/admin/ (
admin@example.com/admin123)
Stop it with Ctrl+C. --rm removes the container when it stops, so no stopped demo containers pile up and the next run starts from the demo state again.
Replace v1.7.3 with the release you want to try. Release candidates have their own tags (e.g. v1.7.4-RC1), and latest follows the newest final release. All tags are listed in the package registry. Images exist from the first release that contains the demo image (v1.7.2-RC2).
Settings
Variable |
Default |
Purpose |
|---|---|---|
|
|
URL the shop is reached under. Set it when you use another port or host, e.g. |
|
|
Admin login |
|
|
Admin password. Set your own for anything reachable by others. |
|
|
Versions after 1.7.2, HTTPS only: |
|
(none) |
Versions after 1.7.2, |
|
|
Versions after 1.7.2, |
Run under another URL
The shop builds its links from O3_SHOP_URL. If you open it under any address other than http://localhost:8080 (another port, the machine’s IP address or a host name), set the variable to exactly that address. Otherwise links point to the wrong place.
docker run --rm -p 9000:80 -e O3_SHOP_URL=http://localhost:9000 ghcr.io/o3-shop/o3-shop-demo:v1.7.3
docker run --rm -p 80:80 -e O3_SHOP_URL=http://demo.example.com ghcr.io/o3-shop/o3-shop-demo:v1.7.3
The URL is applied every time the container starts. To change it, create a new container with the new value; with the named volumes from “Keep your changes” below, your data carries over. Only a plain http(s):// URL is accepted (letters, digits and . : _ ~ / - [ ]); anything else stops the container at startup with an error message. https URLs have further requirements, see HTTPS.
HTTPS
Note
HTTPS (both modes, and the variables O3_HTTPS, O3_ACME_EMAIL, O3_ACME_STAGING) is available in images for versions after 1.7.2: v1.7.3 and newer, and the release candidates from v1.7.3-RC1. In v1.7.2 and older, an https URL only changes the shop’s links; the container doesn’t serve HTTPS.
Warning
An HTTPS demo is reachable by others: always set your own admin password (O3_ADMIN_PASSWORD, as in the examples below). The default admin123 is published on this page.
With a Let’s Encrypt certificate
With an https:// URL the demo serves the shop over HTTPS itself: Apache obtains a Let’s Encrypt certificate for the host and renews it while the container runs. Using an https URL accepts the Let’s Encrypt Subscriber Agreement.
docker run --rm -p 80:80 -p 443:443 \
-e O3_SHOP_URL=https://<your-host> \
-e O3_ADMIN_PASSWORD='<your-password>' \
-v o3-demo-certs:/etc/apache2/md \
ghcr.io/o3-shop/o3-shop-demo:v1.7.3
Requirements: the host name resolves to the machine, and ports 80 and 443 are reachable from the internet as they are. Let’s Encrypt checks the host over port 80; an https URL with another port stops the container at startup.
Redirects: plain http requests, and https requests by IP address or another host name, are redirected to the shop’s https URL.
First start: until the certificate is active (usually within a minute), https requests for the host get
503 Service Unavailable.docker logsshows the progress. If Let’s Encrypt can’t issue the certificate, a line says so, the errors before it name the cause, and Apache retries automatically.Keep the certificates in a named volume (
/etc/apache2/md, as above). Without one, every new container requests a new certificate, and Let’s Encrypt limits how many duplicate certificates a host gets per week.Public host names only:
localhost, IP addresses, reserved names (.test,.local,example.comand its subdomains, …) and names without a dot stop the container at startup. For local tests, use an http URL.Testing:
O3_ACME_STAGING=1uses the Let’s Encrypt staging CA. Give it a separate certificate volume, so a later production run doesn’t start from the untrusted staging certificate.
Behind a reverse proxy
If a reverse proxy (nginx, Traefik, Caddy, …) terminates TLS and forwards plain http to the container, set O3_HTTPS=proxy. The container then uses no certificate and doesn’t redirect; the shop builds https links and treats every request as https. Any host name and port work, localhost included:
docker run --rm -p 127.0.0.1:8080:80 \
-e O3_SHOP_URL=https://shop.example.org -e O3_HTTPS=proxy \
-e O3_ADMIN_PASSWORD='<your-password>' \
ghcr.io/o3-shop/o3-shop-demo:v1.7.3
Warning
Make the container reachable only by the proxy (bind the port to 127.0.0.1 as above, or use a private Docker network). The shop treats every request as https, also one that bypasses the proxy over plain http.
The proxy must forward the original Host header (nginx: proxy_set_header Host $host;).
Keep your changes
With --rm, as in the examples on this page, Docker removes the container when it stops, and your changes go with it. To keep them across containers, use named volumes for the database and the uploaded pictures:
docker run --rm -p 8080:80 \
-v o3-demo-db:/var/lib/mysql \
-v o3-demo-pictures:/var/www/html/source/out/pictures \
ghcr.io/o3-shop/o3-shop-demo:v1.7.3
On first use Docker fills empty named volumes with the image’s demo data. Don’t use empty bind mounts (host directories) for these paths: they hide the installed data and the shop won’t start. A volume created with an older image keeps that version’s database, so start with fresh volumes when you switch to a newer release.
E-mail
The demo sends no e-mail. Registration, order and newsletter mails are accepted and then discarded; docker logs shows one line per discarded mail with its recipient. The shop’s SMTP settings stay empty even if you set them in the admin.
Note
The v1.7.2-RC2 and v1.7.2-RC3 images predate this: there, any action that sends a mail (e.g. registering with the newsletter box ticked) ends on the maintenance page. Use the current release, v1.7.3.
Build it yourself
The image is built from the docker/demo/ directory of the o3-shop/o3-shop repository, whose README is the reference for this page:
docker build -f docker/demo/Dockerfile -t o3-shop-demo .