keepcoolch/dockamp repository overview

⁠🐳 DockAMP Docker image or separate macOS app

DockAMP is a Docker image with a responsive web interface to manage official Apache/Nginx, PHP, Python, Node.js, MySQL/MariaDB/PostgeSQL and proxy containers in Docker - also available as a macOS app. Docker version 1.3 | macOS version 1.3 | developed by Kevin Tobler 🌐 www.kevintobler.ch⁠

🐳 The Docker version can run on any Docker-compatible environment. The image includes support for both linux/amd64 and linux/arm64.

🍎 The macOS version supports Docker Desktop and OrbStack (macOS 14.6 Sonoma or newer)

⁠🔄 Changelog Docker version

The most important features added in the available DockAMP releases. Smaller fixes and internal maintenance changes are intentionally summarized.

⁠🆕 Version 1.3.x

⁠V.1.3.3

• New automatic backup intervals for every hour and every 3, 6, or 12 hours.
• Bilingual changelog available directly from the DockAMP sidebar.
• Improved overlay scrolling with a locked page background and a dedicated scrolling area.
• Improved mobile layout with stable form zoom, dynamic viewport height, and cleaner separators.

⁠V.1.3.2

• Optional PROXY Protocol support for the internal Nginx Proxy Manager with automatic restart when toggled.
• Configurable real client IP detection for Nginx and Apache with editable trusted networks.

⁠V.1.3.1

• Automatic proxy host management in Nginx Proxy Manager using stored credentials.
• Existing proxy hosts can be adopted while preserving custom NPM configuration and locations.
• Automatic certificate requests for valid domains and proxy status information in the server overview.

⁠V.1.3.0

• Python and Node.js app servers with version selection, framework defaults, dependencies, and custom start commands.
• App file browser, default apps, additional mounts, permission checks, and database integration for app servers.
• Python and Node.js support in backups, restore, recovery Compose, and image updates.
• Servers can be freely reordered in the sidebar.

⁠Version 1.2.x

⁠V.1.2.13

• Faster parallel bulk actions for starting and stopping multiple servers.
• Dedicated database volume names can be customized.

⁠V.1.2.12

• Isolated runtime mounts per server instead of exposing the complete data directory to web and PHP containers.
• Automatic detection and recreation of containers using the previous mount structure.

⁠V.1.2.11

• Two step SQL import with preview, large dump support, and reliable temporary file cleanup.
• Multiple database selection for global imports and target rewriting for server databases.
• Detection of incompatible database engines and improved compatibility between MySQL and MariaDB.

⁠V.1.2.10

• Database names and credentials can be changed later and synchronized with running containers.

⁠V.1.2.9

• Expanded Compose management in Container Center with editing, copying, renaming, and rerunning.
• Safer detection of protected and unused DockAMP images.

⁠V.1.2.8

• New Container Center for status, actions, logs, and importing Docker Compose or Docker run configurations.

⁠V.1.2.7

• Automatic cleanup of unused database administration containers and global database services.

⁠V.1.2.6

• Database image and data checks with migration while preserving the existing state.

⁠V.1.2.5

• Maintenance release with updated version information and update metadata.

⁠V.1.2.4

• Recovery Compose export with restoration information for operation without DockAMP.

⁠🐳 Docker version

⁠🚀 Main features of the Docker version

• Browser-based management interface in English and German
• Web/PHP, Python, or Node.js server types
• Apache or Nginx for each Web/PHP server
• Automatic PHP version discovery with legacy PHP versions available
• Automatic Python and Node.js version discovery
• Advanced PHP, Apache, and Nginx configuration with structured dropdowns for common values
• Python app support with FastAPI, Flask, Django, Streamlit, Gradio, and generic Python apps
• Node.js app support with Express, Fastify, Next.js, Vite, Nuxt, and generic Node.js apps
• Per-app start commands, install commands, package/runtime settings, and automatic default starter files
• Python requirements management with per-server requirements files and optional virtualenv volumes
• Node.js package handling with package.json/lockfile detection and optional node_modules Docker volumes
• Apache and Nginx security header controls for X-Frame-Options, Referrer-Policy, CSP, and related directives
• MySQL, MariaDB, and PostgreSQL
• Shared global or dedicated per-server database containers
• Automatic database image and data migration checks
• Nginx Proxy Manager integration
• phpMyAdmin integration
• Adminer integration for PostgreSQL databases
• SQL dump exports
• Container logs and status overview
• Live visitor overview with active request paths and per-server traffic speed
• Automatic free web-port selection starting above DockAMP's own port
• CPU and memory limits based on the available Docker host resources
• Docker volumes or host paths for persistent storage
• Initial setup can detect and choose Docker volumes or host mounts for /data and /sites
• Separate storage handling for DockAMP configuration and website/runtime files
• Storage migration between Docker volumes and host mounts where supported
• Host folder browser for document roots, host mounts, additional server mounts, and backup targets
• Folder creation and safer folder deletion dialogs in folder browser views
• Website and app file browser for document roots, Python apps, Node.js apps, and additional mounts
• Upload files or whole folders directly through the browser
• Rename, copy, move, delete, and download website files or folders
• Download folders as compressed archives
• Webserver and app permission checks for document roots, app paths, package/requirements files, and additional mounts, with repair actions
• Global image update checker for DockAMP-managed images, including DockAMP itself, web servers, PHP runtimes, Python and Node.js runtimes, database tools, proxy, Adminer, phpMyAdmin, and helper images
• DockAMP-managed unused image cleanup
• DockAMP-managed unused volume overview with individual delete actions
• User login and account management
• Automatic container restart and auto-start options
• Backup and restore support for Docker volumes and host-mounted storage paths
• Backup selection for DockAMP config, sites/runtime files, Python and Node.js app files, mounted web/app paths, dedicated databases, global database, and Proxy Manager data
• Optional restore selection per backup archive plus backup download as a compressed archive
• DockAMP automatically exports Docker Compose files, runtime files, Python requirements, and Node.js recovery commands so your containers can be started without DockAMP if needed.

⁠Linux and NAS

The following command stores DockAMP configuration and website data in named Docker volumes:

docker run -d \
  --name dockamp \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v dockamp_data:/data \
  -v dockamp_sites:/sites \
  --add-host host.docker.internal:host-gateway \
  keepcoolch/dockamp:latest

When using a persistent host-mount:

docker run -d \
  --name dockamp \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /volume1/path-to-folder/data:/data \
  -v /volume1/path-to-folder/sites:/sites \
  -e DOCKAMP_DATA_HOST_PATH=/volume1/path-to-folder/data \
  -e DOCKAMP_SITES_HOST_PATH=/volume1/path-to-folder/sites \
  --add-host host.docker.internal:host-gateway \
  keepcoolch/dockamp:latest

This is also the recommended starting point for Docker-capable NAS systems. The Docker socket may need to be selected through the NAS Docker Manager.

⁠macOS with Docker Desktop

docker run -d \
  --name dockamp \
  --restart unless-stopped \
  -p 8080:8080 \
  -v "$HOME/.docker/run/docker.sock:/var/run/docker.sock" \
  -v dockamp_data:/data \
  -v dockamp_sites:/sites \
  --add-host host.docker.internal:host-gateway \
  keepcoolch/dockamp:latest

Host directories selected later as document roots must be shared with Docker Desktop under Settings -> Resources -> File Sharing.

⁠macOS with OrbStack

docker run -d \
  --name dockamp \
  --restart unless-stopped \
  -p 8080:8080 \
  -v "$HOME/.orbstack/run/docker.sock:/var/run/docker.sock" \
  -v dockamp_data:/data \
  -v dockamp_sites:/sites \
  --add-host host.docker.internal:host-gateway \
  keepcoolch/dockamp:latest

⁠Docker Compose

Create a compose.yaml file with docker volumes:

services:
  dockamp:
    image: keepcoolch/dockamp:latest
    container_name: dockamp
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - dockamp_data:/data
      - dockamp_sites:/sites
    extra_hosts:
      - "host.docker.internal:host-gateway"

volumes:
  dockamp_data:
  dockamp_sites:

When using a persistent host-mount:

services:
  dockamp:
    image: keepcoolch/dockamp:latest
    container_name: dockamp
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /volume1/path-to-folder/data:/data
      - /volume1/path-to-folder/sites:/sites
    environment:
      - DOCKAMP_DATA_HOST_PATH=/volume1/path-to-folder/data
      - DOCKAMP_SITES_HOST_PATH=/volume1/path-to-folder/sites
    extra_hosts:
      - "host.docker.internal:host-gateway"

Start DockAMP:

docker compose up -d

On macOS, replace /var/run/docker.sock in the Compose file with:

${HOME}/.docker/run/docker.sock

For OrbStack use:

${HOME}/.orbstack/run/docker.sock

⁠How to open the dashboard:

After startup, open:

http://localhost:8080

On a remote server or NAS, replace localhost with the IP address or hostname of the Docker host. The first visit opens the administrator account setup.

⁠Using host directories

Individual server document roots can also point to absolute paths on the Docker host. Those paths must be accessible to the Docker daemon.

DockAMP includes a host folder browser for supported Docker environments. It can help select document roots, storage paths, and additional mounts from host paths that are visible to the Docker daemon.

⁠Persistent data

• /data: DockAMP configuration, users, sessions, application state, generated runtime configuration, and compose export
• /sites: website files
• Database and Proxy Manager data: separate named volumes by default

During the first setup, DockAMP shows the detected storage method for /data and /sites and lets you keep Docker volumes or switch to host mounts. The same storage areas can also be adjusted later from the Storage page.

⁠Updates

You can update DockAMP directly from the dashboard, so there's no need to run manual update commands in the terminal.

⁠Notes

⁠📸 Screenshots Docker version

⁠🧑‍💻 Developer

Kevin Tobler
🌐 www.kevintobler.ch⁠