PHP7/8 application development containers.
see (http://github.com/infracamp/kickstart) for more information.
Use -min images in Dockerfile and main image in .kick.yml
|unstable||Ubuntu 20.04 (master), PHP8||master||unstable||Readme|
Kickstart uses a fixed version of Ckit to keep the features freeze within a version.
The container comes with no additional Modules pre-installed except xdebug. You might
want to add the following packages to your .kick.yml
packages: section to install them.
You’ll find all available modules by running
apt update && apt search php8.0
Example: Using Curl
packages: [php8.0-curl, php8.0-http, php8.0-raphf]
By default, the document root points to
/opt/www with a FallbackResource
/index.php. You can add specific Options using the
See kickstart/conf/ for default configuration. You can
override these by placing the files into
.kicker/conf/ directory of your
project. The configuration will be written each time the container starts.
So you can add specific configuration based on ENV settings.
Make sure your IDE has plugins installed for:
Xdebug is enabled by default if you are in development mode (the project is run by kickstart.sh)
Xdebug is configured to connect the IDE on the
Docker-Host-IP (which is the first configured IP of your
host machine - determined by kickstart.sh) on Port
Activate remote debugging in Settings:
Open Run > Edit configurations…
The idekey and serverName is the name of your project!
Enable Path Mappings:
configNameis the same of your project name
To start debugging via browser open:
just set the breakpoint
If debugging won’t work, use our checklist to determine the cause:
1) Verfiy with PhpStorm Debug validator. (Make sure
Path to validation script is the
full path to your www-root)
1) Check the docker-host’s IP was propagated correctly.
- The IP should be set as environment-variable
- Inside the container type
echo $DOCKER_HOST_IP should print your ip
> A) Check kickstart.sh is the newest version (perform ./kickstart.sh --upgrade) > B) Solution: Check `hostname -i` returns your primary IP address on your > host machine.
2) Check the IDE is connectable from within the container on Port
9003 (new port since PHP8.0)
- Install netcat and try the script below:
sudo apt install netcat
nc -zw3 $DOCKER_HOST_IP 9000 && echo "OK: IDE is reachable on port 9003" || echo "ERROR: IDE unreachable"
> A) Check if you can reach this PORT from outside the container. If not your IP might be wrong,
> or your IDE is not correctly configured.
3) Check your IDE-Settings.