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.

# 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.