TYPO3 Screenshots Docker container

We have prepared a Docker container that you can use to create screenshots for the official documentation, which already follows out Guidelines for screenshots.

Table of content

Quick screenshots using Docker

You can run the screenshot project locally using the prebuilt Docker image:

docker run -d --name typo3-screenshots -p 8080:80 linawolf/typo3-screenshots

# Follow the logs to track progress:
docker logs -f typo3-screenshots

Once setup is complete, open:

http://localhost:8080/typo3

Note

The container resets on every run. It is ideal for reproducible test environments and fresh screenshots.

Resetting the container

To start fresh, you can stop and remove the running container, then launch it again.

docker stop typo3-screenshots
docker rm typo3-screenshots
docker run -d --name typo3-screenshots -p 8080:80 linawolf/typo3-screenshots

This gives you a clean TYPO3 instance every time.

Accessing the container shell

You can access the container's shell to explore the file system, install additional extensions, or run TYPO3 CLI commands:

docker exec -it typo3-screenshots bash

This drops you into a terminal session inside the container.

After accessing the container shell, you can exit at any time by typing:

exit

This will close the interactive shell session and return you to your host terminal.

Installing additional extensions with Composer

Once inside the container (via Accessing the container shell), you can install TYPO3 extensions using Composer. For example:

composer require typo3/cms-lowlevel

Then you can run the setup command to register the extension:

./vendor/bin/typo3 extension:setup

Note

Since the container resets every time, any installed extension will be lost on restart unless you build a new image with those extensions included. This is intentional to ensure a consistent environment for screenshots.

Running TYPO3 CLI commands

To run any TYPO3 CLI command inside the container, use:

docker exec -it typo3-screenshots ./vendor/bin/typo3 <command>

Examples:

docker exec -it typo3-screenshots ./vendor/bin/typo3 list
docker exec -it typo3-screenshots ./vendor/bin/typo3 extension:setup
docker exec -it typo3-screenshots ./vendor/bin/typo3 language:update