devilbox/docs/examples/setup-typo3.rst
2018-07-26 09:38:45 +02:00

3.1 KiB

Setup Typo3

This example will use composer to install Typo3 from within the PHP container.

Table of Contents

local

Overview

The following configuration will be used:

Project name VirtualHost directory Database TLD_SUFFIX Project URL
my-typo /shared/httpd/my-typo my_typo loc http://my-typo.loc

Walk through

It will be ready in eight simple steps:

  1. Enter the PHP container
  2. Create a new VirtualHost directory
  3. Install Typo3 via composer
  4. Symlink webroot directory
  5. Setup DNS record
  6. Create FIRST_INSTALL file
  7. Open your browser
  8. Step through guided web installation

available_tools

1. Enter the PHP container

host> ./shell.sh

work_inside_the_php_container

2. Create new vhost directory

devilbox@php-7.0.20 in /shared/httpd $ mkdir my-typo

3. Install Typo3

devilbox@php-7.0.20 in /shared/httpd $ cd my-typo
devilbox@php-7.0.20 in /shared/httpd/my-typo $ composer create-project typo3/cms-base-distribution typo3
devilbox@php-7.0.20 in /shared/httpd/my-typo $ ln -s typo3/public htdocs

5. DNS record

If you do not have setup_auto_dns configured, you will need to add the following line to your host operating systems /etc/hosts file (or C:\Windows\System32\drivers\etc on Windows):

127.0.0.1 my-typo.loc
  • howto_add_project_hosts_entry_on_mac
  • howto_add_project_hosts_entry_on_win
  • setup_auto_dns

6. Create FIRST_INSTALL file

To continue installing via the guided web install, you need to create a file called FIRST_INSTALL in the document root.

devilbox@php-7.0.20 in /shared/httpd/my-typo $ touch htdocs/FIRST_INSTALL

7. Open your browser

Open your browser at http://my-typo.loc.

8. Step through guided web installation

  1. Select database
    • Connection: Manually configured MySWQL TCP/IP connection
    • Username: root
    • Password
    • Host: 127.0.0.1
    • Port: 3306
  2. Select database
    • Create a new database: typo3
  3. Create Administrative User / Specify Site Name
    • Username: admin
    • Password: choose a secure password
    • Site name: My Typo
  4. Installation complete
    • Create empty starting page