Attention

TYPO3 v8 has reached its end-of-life March 31st, 2020 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.

There is no further ELTS support. It is recommended that you upgrade your project and use a supported version of TYPO3.

Get and Unpack the TYPO3 Package¶

Installing on a Unix server¶

Get the Source Package from https://typo3.org/download/ and upload this package to your web server. Put it one level above the document root. For this manual, we will use the .tar.gz file. (If you are not sure which package you should choose, read the section "Which Package and which Format?" in the in-depth part of the manual). Use the shell to execute the according commands:
```
/var/www/site/htdocs/$ cd ..
/var/www/site/$ wget get.typo3.org/8.7 -O typo3_src-8.7.x.tar.gz
```
Unpack the typo3_src-8.7.x.tar.gz file on your web server:
```
/var/www/site/$ tar xzf typo3_src-8.7.x.tar.gz
```
Note

Be aware that the x in the extracted folder will be replaced with the latest bugfix version, e.g. typo3_src-8.7.8.

Tip

You can also unpack the package on your local PC and then upload the unpacked contents. However, the package contains thousands of files, so if you're able to unzip or untar the package on the server, better do that!

Create these symlinks in your document root:

cd htdocs
ln -s ../typo3_src-8.7.x typo3_src
ln -s typo3_src/index.php index.php
ln -s typo3_src/typo3 typo3

Create an empty file FIRST_INSTALL to enable the Install Tool to set up and configure the instance in the next step:
```
touch FIRST_INSTALL
```

In case you use the Apache web server, copy the .htaccess file to your document root:

cp typo3_src/_.htaccess .htaccess

You end up with the following structure of files:

typo3_src-8.7.x/
htdocs/typo3_src -> ../typo3_src-8.7.x/
htdocs/typo3 -> typo3_src/typo3/
htdocs/index.php -> typo3_src/index.php
htdocs/.htaccess
htdocs/FIRST_INSTALL

The advantage of this setup is that all files from the TYPO3 Source package are kept together in the typo3_src-8.7.x folder and separated from other files of your installation. This allows you to easily exchange this folder when a new patchlevel version of TYPO3 is released.

Note

This setup allows the administrator to use the "Core Updater" feature in the Install Tool to later easily update the TYPO3 Source files.

Installing on a Windows server¶

Get the Source Package from https://typo3.org/download/ and extract it on your local PC. Use FTP, SFTP or similar to upload the contents of this package to your web server. Put them one level above the document root. For this manual, we will use the .zip file. (If you are not sure which package you should choose, read the section "Which Package and which Format?" in the in-depth part of the manual).

Use the shell to create these symbolic links in your document root:

cd htdocs
mklink /d typo3_src ..\typo3_src-8.7.x
mklink /d typo3 typo3_src\typo3
mklink index.php typo3_src\index.php

In case you use the Apache web server, copy the .htaccess file to your document root:

copy typo3_src/_.htaccess .htaccess

You end up with the following structure of files:

typo3_src-8.7.x/
htdocs/typo3_src -> ../typo3_src-8.7.x/
htdocs/typo3 -> typo3_src/typo3/
htdocs/index.php -> typo3_src/index.php
htdocs/.htaccess