.. include:: /Includes.rst.txt .. index:: single: Linux single: Setup; Linux .. _setting-up-typo3-manually-linux: ===================================== Setting up TYPO3 manually under Linux ===================================== Prerequisites ============= You will need a Webserver, PHP and database on your system. Look at the page `System requirements `__ and check out the specific system requirements for the current main branch on the `Download TYPO3 `__ page. Just as a minimal example, this is a list of packages you might want to install on a Debian flavored Linux system (e.g. Ubuntu). .. important:: This is a very simple, minimal setup. You might want to use Nginx instead or php-fpm with Apache. Setup ===== Apache Webserver ----------------- .. code-block:: bash :caption: shell command sudo apt-get install apache2 sudo a2enmod deflate rewrite headers mime expires .. note:: To allow override with :file:`.htaccess` files for your TYPO3 base directory change `AllowOverride` from `None` to `ALL` https://httpd.apache.org/docs/2.4/en/mod/core.html#allowoverride PHP --- .. note:: You may have to add a PPA (ondrej/php) to get the latest PHP version. If you are not familiar with doing that, consider using :ref:`DDEV `. Install the latest PHP version for the core development branch (see `composer.json `__ in TYPO3 repository on GitHub), including the required PHP extensions listed in :ref:`System requirements `. .. code-block:: bash :caption: shell command sudo apt-get install libapache2-mod- php-cli ... Make some changes to php.ini and reload. Also refer to the :ref:`System requirements ` for the recommended values, but you may want to increase the values for your development environment. Make some changes to php.ini (or appropriate file in :file:`conf.d`) and reload: .. code-block:: ini :caption: php.ini (or other PHP config filename) memory_limit = 512M max_execution_time = 240 max_input_vars = 1500 Restart Webserver: .. code-block:: bash :caption: shell command sudo service apache2 restart MySQL Server ------------ .. code-block:: bash :caption: shell command sudo apt-get install mysql-server ImageMagick ----------- .. code-block:: bash :caption: shell command sudo apt-get install imagemagick Create a basic site for your installation ----------------------------------------- Edit a sitefile, make sure it will point to the correct htdocs directory: .. code-block:: apacheconf :caption: /etc/apache2/sites-available/t3coredev.conf ServerAdmin youremail@yourdomain ServerName t3coredev DocumentRoot /var/www/t3coredev ErrorLog ${APACHE_LOG_DIR}/error.log CustomLog ${APACHE_LOG_DIR}/access.log combined Enable it: .. code-block:: bash :caption: shell command sudo a2ensite t3coredev sudo service apache2 reload Create a domain in your /etc/hosts ---------------------------------- .. code-block:: text :caption: /etc/hosts 127.0.0.1 localhost t3coredev You will now be able to access your TYPO3 installation via http://t3coredev/typo3/ and it will greet you with an error message, because it is not configured yet Next step ========= Proceed with :ref:`setting-up-typo3-manually`.