The Admin Tool

Tip

The “Admin Tool” was formerly called “Install Tool”.

  1. Hit the start page of your freshly created site with your browser and you should see the “thank you for downloading”-message.

    Success message after download.

    Success message after download.

  2. Create the file FIRST_INSTALL in your web root directory (public folder) and reload the page. You will be redirected to the install tool. It will guide you through the steps for installing TYPO3. The Install Tool is located in ‘typo3/install’ in your installation which for example would be http://www.example.com/typo3/install.php.

  3. This is what you should see:

    first step

    Install Tool in 1-2-3 mode, first step.

  4. In case you have problems in your Environment, you will get warnings or hints in this screen. In this case, you should try to fix them; the “Troubleshooting” section might help you.

  5. Choose database connection. In this step, you can choose the database management system TYPO3 should run with. Via the GUI you can choose between MySQL (compatible to MariaDB), PostGres or SQLite if available. SQLite requires no further configuration and is a good choice for testing TYPO3, but you should choose one of the others for running production grade web sites.

    third step

    Install Tool in 1-2-3 mode, second step.

  6. Choose Database. If you did not select SQLite in the previous step, you have to select an empty database for TYPO3 now (or create one if your user is allowed to).

  7. Enter a username and password for your first TYPO3 administrator account. (For security reasons, it’s best not to use the name admin.) This password will also be used for the Install Tool. The “site name” will identify this installation (in the page tree and browser title).

    forth step

    Install Tool in 1-2-3 mode, forth step.

  8. In the last step you can choose whether you want to start with an empty TYPO3 or if you want to have a basis to start from.

    fifth step

    Install Tool in 1-2-3 mode, fifth step.

    Tip

    If you wish to install the “Introduction Package” in order to create a demo site, choose:

    • With Composer: “Take me straight to the backend”
    • Without Composer: “Get preconfigured distributions”

    Proceed with Install Introduction Package

If you do not wish to install the “Introduction Package”, choose “Take me straight to the backend” or “Create empty starting page”

The installation is now complete.

Find some more tips in Next steps.