Docker Environment
The APPNETOS Docker repository provides a reproducible local development environment.
Current components
| Component | Purpose |
|---|---|
| Apache 2.4 | HTTP web server |
| PHP 8.5 FPM | PHP runtime |
| MongoDB | Primary database |
| Redis | Cache and supporting runtime services |
| Xdebug | Development debugging |
| Composer | Application dependencies |
Repository and workspace
The Docker repository contains Compose definitions, Dockerfiles and configuration. The APPNETOS core and
the
applications selected for the installation are placed in the
workspace/
directory. The
following
names are illustrative; only the applications required for a deployment need to be included.
workspace/
└── appnetos/
├── appnetos/
├── application-one/
├── application-two/
├── application-three/
├── public/
└── scripts/
Development ports
The documented default host ports are HTTP
20000
, MongoDB
20010
and Redis
20011
. They can be adjusted through
.env
.
Debugging
The development environment provides Xdebug and sets
PHP_IDE_CONFIG=serverName=APPNETOS
. In
PhpStorm, use the server name
APPNETOS
, host
localhost
, port
20000
and
the corresponding local-to-container path mapping.
Xdebug must not be enabled in production environments. Disable or remove the Xdebug extension in production PHP containers to avoid unnecessary performance overhead and potential exposure of debugging information.
Future development
Docker service composition is planned to become more application-specific. The instructions on these pages document the current setup and will be updated when that change is implemented.