Get and Unpack the TYPO3 Package

Installing on a Unix server

  1. Get the Source Package from http://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
    
  2. 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!

  3. 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
    
  4. 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
    
  5. 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

  1. Get the Source Package from http://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).

  2. 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
    
  3. 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