Getting Started with TYPO3

TYPO3 is an Open Source CMS written in PHP. To get more information, visit their website.

Create Environment

First you have to create a website on your server. Our website module provides everything you need to manage, deploy and run your website. Every Website is type based, which means you have to select a particular type.

  1. Log in to cockpit.opsone.ch

  2. Choose your server or create a new one

  3. Go to websites, and create a new one

  1. Select website type TYPO3 and fill in all settings

Tip

Depending on what TYPO3 Version you choose, the correct core will be installed and available for use.

Tip

You don’t need to remember your DB credentials. We always provide them as environment variables.

According to those settings, our automation will setup the server/vhost as required.

Access with SSH

On the server you can work with SSH. Due to security reasons, we allow key based logins only.

  1. If you don’t have an SSH key: Create an SSH key pair

  2. Add your SSH Public Key in the Cockpit: Either for the whole server or within the website.

  3. Now you can log in via SSH. Username is your chosen website name.

Tip

Wondering why your existing SSH key is not working? Maybe it does not meet our minimum requirements.

Install TYPO3

We recommend that you install TYPO3 via composer to have full control over the update cycle. However, if you want to use the TYPO3 core provided by us, you are welcome to do so. We update the TYPO3 core shortly after the official release. Please note that we provide the core as is and do not perform any additional testing.

If you want to install TYPO3 via composer, follow the instructions provided by the TYPO3 Documentation.

To use the TYPO3 core we provide, follow the instructions below.

Note

Check the different TYPO3 Types in our Overview to get the specific Version configurations and TYPO3 core directories.

The webroot of your website may vary depending on what TYPO3 Version you select and can also be checked in the Type Overview linked above.

SSH Session
# switch to your webroot
$ cd ~/[webroot]

# create symlinks for TYPO3
$ ln -s /opt/typo3/[TYPO3-Version] typo3_src
$ ln -s [path-to-webroot]/typo3_src/typo3 typo3
$ ln -s [path-to-webroot]/typo3_src/index.php index.php

# Create FIRST_INSTALL file
$ touch FIRST_INSTALL

You are now ready to finish the install in the web browser. Note that the Database username ist the same as the Website Name and the Password can be found in the cockpit. Make sure to safely store your administrator credentials as you will need them to Log into the backend and make Changes in the TYPO3 Maintenance mode.

Request-Limits with TYPO3

Our default website configuration contains webserver limitations to reduce the risk that too many requests from one single client could overload the server. Working in the TYPO3 backend can generate a lot of requests towards the webserver - and even clash with the default limits.

Should this cause a problem for you (e.g. seeing 429 too many requests errors in your browser console or the webserver logs), you should fine-tune these limits: Find an example for how to set limits for TYPO3 in the section about request limits.

Note

As both these limits and the location of the .htaccess file are specific to your project, we don’t deliver this configuration automatically and you need to include it in your configuration yourself.