Requirements / tool configuration


Important: When using Windows, you must configure your GIT client to not convert line endings to windows line endings BEFORE cloning this GIT repository.

Note: It’s also possible to develop and serve a Laravel application with Gentics Portal | php without Docker, but it makes development a lot easier, that’s why it is listed as requirement here.

git config --global core.autocrlf input

Read the section Installing the required tools - more specific for more specific details on how to install and configure the required tools. If you encounter any Docker specific errors, you maybe find a solution on this page here.

Authentication for /

Contact Gentics if you have not received your credentials for / yet.


Open the composer file auth.json. You can also edit %USERPROFILE%\AppData\Roaming\Composer\auth.json or ~/.composer/auth.json instead.

composer config --global --auth --editor

Make sure your auth.json contains the following configuration:

    "http-basic": {
        "": {
            "username": "MYUSERNAME",
            "password": "MYPASSWORD"

Replace MYUSERNAME and MYPASSWORD. It’s also advised to use the encrypted password here, which can be generated in your Artifactory profile page.


Log in into the docker registry and use the same credentials like above:

docker login

Next steps

Continue with Run the demo or New Laravel project.

Installing the required tools - more specific



Install the GIT client from

Make sure to enable "Checkout as-is, commit Unix-style" when the installer asks you.

Linux / Mac

Install the package "git" with the package manager.


Windows / Mac

  • Use Docker with Hyper-V if available

  • We recommend to increase the memory to at least 4 GB or better 6GB and set the available CPU to all CPU cores in the Docker settings


Check if PHP 7.4 is already installed by running php -version

If your operating system has a packet manager with PHP 7.4, install the package, otherwise download PHP from (PHP 7.4 "VC15 x64 Non Thread Safe" for Windows) and install the required PHP modules as well.

Also the following PHP modules are required (some of these are already available depending on your setup): dom, curl, exif, intl, json, xmlwriter, xml

Building the Dockerfile

If you do any changes do the Dockerfile or files in portal-files, you have to run

docker-compose build