How to install TYPO3 8.0 as a local test system in Windows – Our tutorial

The new TYPO3 8.0 version is already available for a couple of weeks now. Some of you might want to check it out on their own computers. Like before with TYPO3 7LTS here is our installation guide.

Follow @PagemachineAG

Diesen Beitrag gibt es in unserem Blog auch auf Deutsch.

You can also find this tutorial for the version 7 LTS, as well as for the updated 8.7 and 9 LTS versions.

In order to get TYPO3 8.0 running on your own computer the following stuff is required:

• A web server with a database and with PHP. The XAMPP package is perfect for the trial. It is available at Apache Friends as a free download  apachefriends.org
• GraphicsMagick, without it image processing wouldn’t work with TYPO3 ftp://ftp.graphicsmagick.org/pub/GraphicksMagick/windows/
• Furthermore, an editor for creating and editing text files. Suitable are the Windows Editor, PSPad, or others  e.g. Notepad++.
• And, last but not least, TYPO3 in the current version. The zip file can be downloaded from typo3.org  https://typo3.org/download/

And off we go with TYPO3 8.0

1. Install the XAMPP webserver

The downloaded file will install itself. At the moment there’s only a 32Bit version available but on my 64Bit-system it runs smoothly.

It’s possible that the virus scanner throws a warning. For most virus scanners or firewalls it is sufficient to ignore this warning. Others need to be disabled during installation. In addition, a warning due to restrictions by the UAC might pop up.

When released you could find information concerning the UAC (User Account Control) on the official Microsoft site http://windows.microsoft.com/de-de/windows/what-is-user-account-control#1TC=windows-7
We regret that this information is no longer availlable.

All default settings can be left unchanged for the installation.

Afterwards, if necessary, UAC must be disabled for XAMPP. A good guide for this can be found on Petri IT Knowledgebase  https:// www.petri.com/disable-uac-in-windows-7

Apache and MySQL will run via the control panel now. To get this done it is required to run XAMPP as an administrator.

When the two modules are highlighted in green in the active panel (see picture above) you can start the further installation by invoking the URL “localhost” within a browser of your choice. The local Apache friends page appears.

2. Install GraphicsMagick

Installing GraphicsMagick is self-explaining. You just have to choose between the version for 32- or 64-bit operating system (You may find out which one you have by pressing the Windows key and the Pause key simultaneously). By default, it will be installed in „C:\Program Files\GraphicsMagick-1.3.23-Q16“, which should works fine for you.

3. Set up and configure TYPO3 CMS 8.0

For the next step, you have to pass a folder in the directory „C:\xampp\htdocs“, which for example is named „site“. There you can copy all the files and folders of TYPO3 CMS 8.0 after you’ve unpacked „typo3_src-8.0.1.zip“.
Entering „http://localhost /site/“ in your browser will open „Index of/site“. Click on the folder „typo3_src-8.0.1/“ which is listed there and you will see the following page:

Creating the file FIRST_INSTALL
By creating this file TYPO3 virtually provides an access authorization for the file directory. You create the new file with a windows editor and store it in the following directory „C:\xampp\htdocs\site“. The appendix (.txt) generated by the editor has to be removed.

Important thereby: Please copy only the content of the folder into the file. Putting the complete folder in it wont work.

After that „http://localhost/site/“ has to be reloaded and the installation routine starts by clicking the folder „typo3_src-7.6.0/“. Unfortunately, several errors will appear. TYPO3 has some special requirements to the server which are not fulfilled by the standard configuration.

The first three messages can be resolved by changing the entries in the „php.ini“ file with an editor. The file is located in the folder „C:\xampp\php\“. It basically configurates PHP.

1);extension=php_soap.dll will be activated by removing the semicolon
2) max_execution_time = 30 has to be increased to 240
3) ; max_input_vars = 1000 will be activated by removing the semicolon and has to be increased to 1500 characters

Now restart Apache and MySQL with the XAMPP Control Panel and reload the website. There will be just one error and one warning left.

The „ThreadStackSize“ has to be raised to 8MB. In order to change this setup choose the folder „C:\xampp\apache\conf\“ and write the following lines with a text editor in the file „httpd.conf“:

<IfModule mpm_winnt_module>

ThreadStackSize 8388608

</ IfModule>

As a suggestion:

With the repeated restart of the Apache this message lasts, because TYPO3 8.0 can’t verify the adjustment. However, you can check yourself if enough memory is available now, if the installation has been successful. More on that later.

The last error „PHP OpenSSL extension not working“ can be ignored, since it’s just a local test system. So security is not that important in this case. More on this later, too.

Now you can continue with a click on 

With the next step the MySQL database will be integrated. Sign in with „root“ as username. A password is not required in the XAMPP installer.

Afterwards choose an existing database or create a new one. In our case we have chosen the database called „test“. Recently it is possible to use a different database implementation than MySQL.

Then an admin user is created for the TYPO3 backend. The password you assign will as well be used for the install tool.

Now the installation itself is completed.

If you like you may download some full-fledged websites after the log-in, by tagging „Yes, download the list of distributions“. The Introduction Package includes a comprehensive sample.

Next you may continue by clicking „Open the TYPO3 backend“.
Unfortunately, the login doesn’t work yet, because TYPO3 uses an RSA encryption by default.

Please note: Keep the browser window with the login screen open!

Now you have to enter the configuration again – this time in TYPO3 itself.
For this purpose, open the file „C:\xampp\htdocs\site\typo3conf\LocalConfiguration.php“ with an editor, change the entry in line 7 ‚login security level‘ => ‚RSA‘ to ‚Login securitylevel‘ => ’normal‘ and save.

Then you can log-in at the backend. Now it’s working. If you have closed the browser window accidently, you can reopen the TYPO3 backend with “http://localhost/site/typo3”.

All-important: As long as the extension below wasn’t uninstalled, TYPO3 will overwrite the „login security level“ (from „normal“ back to „RSA“).

If  the login should not work, the entry has to be changed again inside “LocalConfiguration.php” whilst keeping the browser window open.

Currently you can log-in with your username and your password, that you have chosen before. First you should uninstall the extension which is responsible for the RSA because it would overwrite your browser settings again next time you recall the backend. Look for „Extensions“ module listed inside “Admin Tools” and choose the extension RSA.Then click on the tagged icon and it will be deinstalled.

Finally, you have to check in the install tool if the configuration is set properly and integrate GraphicsMagick for image editing.

With the defined password (in our example „password“), you can log in now.

In the menu you choose „Configuration presets“ „Image handling“ and endorse the path to GraphicsMagick.

Now you only have to enter „c: \Program Files\GraphicsMagik-1.3.23-Q16” in „Find executables in this directory“ and click “Activate“. Then select the radio button in GraphicsMagick and again confirm with „Activate“.

At last, you can check whether the recordable graphics are generated correctly with the menu-item „Test Setup“

Now your TYPO3 8.0 trial version is ready for use. Have fun!

DL

Feedback? With pleasure!

We’ve certainly tested the installation ourselves as we did before with version 7LTS. However, if something shouldn’t work as described, we would appreciate your comment.

If it works and you consider our advice helpful, you may like to share our tutorial. Thanks a lot!

Tweet

Follow @PAGEmachineAG