Requirements / tool configuration

Requirements

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 repo.apa-it.at / docker.apa-it.at

Contact Gentics if you have not received your credentials for repo.apa-it.at / docker.apa-it.at yet.

Composer

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": {
        "repo.apa-it.at": {
            "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.

Docker

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

docker login docker.apa-it.at

Next steps

Continue with Run the demo or New Laravel project.

Installing the required tools - more specific

GIT

Windows

Install the GIT client from https://git-scm.com/downloads

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.

Docker

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

PHP

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 https://php.net/downloads.php (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