- Published on
Use GitLab TYPO3 Project Template
- Authors
- Name
- Susanne Moog
GitLab ships a TYPO3 project template that jumpstarts new projects with a working setup and pipeline.
Create from template
- In GitLab, click New Project → Create from template → TYPO3
- Pick a name/namespace and create the project
Run locally (Docker)
Most templates include a docker-compose.yml
or instructions. Typical workflow:
git clone git@gitlab.com:your-namespace/your-typo3-project.git
cd your-typo3-project
# Adjust .env / docker compose as needed
docker compose up -d
Open the app in your browser and finish the TYPO3 install wizard.
CI/CD pipeline
The template comes with a .gitlab-ci.yml
to lint, build, and run tests.
Common stages:
- composer install & cache vendors
- PHP lint/static analysis
- unit/functional tests
- build artifacts (e.g. frontend)
- deploy
Customize the jobs for your hosting and branching strategy.
Tips
- Store secrets in GitLab CI variables (DSN, database creds, etc.)
- Use Composer scripts to standardize tasks (coding standards, tests)
- Add a Makefile for a friendly DX (e.g.
make up
,make test
)
Conclusion
Using GitLab’s TYPO3 template can save hours of setup and provides a solid base with CI out-of-the-box.