Setup own local environment¶
On this page:
All you need is a local running web server. That can be done directly on the machine or with help of Virtual Machines like Vagrant, Docker, XAMPP, MAMP, etc.
If you have a local web server running, be sure you have all requirements needed for using TYPO3 8 LTS:
- >= PHP 7.2
- A database (we are using MariaDB)
- If you want to work on the TER project you do need a Solr Server (v6.6). This is optional for the typo3.org project.
You can find all needed Repositories at our Gitlab server.
To gain access to these repos you need to have a typo3.org Account. If you are not able to login to Gitlab, the reason for this might be, that your Username is not present in our new LDAP environment. To solve this go to https://typo3.org/ and log in there once.
You will find a repository for each project (typo3.org, extensions.typo3.org, my.typo3.org). As these repositories share the same template extension (t3olayout) you will also find this one and all the others. The extensions will be loaded via composer. Issues (Tickets) can be found in this repositories and you will need to send pull requests to them directly.
In this example we will guide you through the process of setting up an installation for typo3.org.
We provide the needed assets for this project (fileadmin and Database). You can download these assets in the Pipeline of Gitlab (link will be provided below) - so you dont have to take care of contents and stuff at all. This ensures that you will have an installation with the latest content up and running. The only thing is that you need to have a backend-user. If this isn’t the case on stage.typo3.org or typo3.org you need to create one using the installtool.
- Clone your repository (in case for typo3.org - find it here)
- Create a new host and point your Document Root to the subdirectory
htmlin the repository
- Create a file
html/typo3conf/AdditionalConfiguration.phpor copy the given
html/typo3conf/AdditionalConfiguration.sample.phpto this name. Edit this file and add the credentials to your local database.
composer installin the root of your project
- Download and extract the ZIP file from GitLab, see Download assets
- Copy the folder
fileadmininto the folder
- Import the
DB.sqlprovided with the Artefacts into your local DB
npm install --prefix=private/typo3conf/ext/t3olayout/Buildon terminal/bash/shell
npm run build --prefix=private/typo3conf/ext/t3olayout/Build
For all those who don’t want to do this or are not able to build these files using npm the latest version of these files are also included in the asset-download. Copy the folders
html/typo3conf/ext/t3olayout/Resources/Publicand you will be able to see the frontend as well.
php vendor/bin/typo3cms install:generatepackagestateson terminal/bash/shell
- If you need a user to login to the backend you need to go to the
installtool. Therefore you need to move to the folder
private/typo3confand create a file named
ENABLE_INSTALL_TOOL. This file can be empty. Then login to
http(s)://yourinstall.local/typo3/install. The standard password (provided in
- Scroll down to the tab ‘important actions’. That is the start page of the
installtool. At the bottom of the page you will find the possibility to
create a new backend user. Create one and login to the backend at