images/README.md
Snider dafabd714c feat: initial core-images repository
Consolidated container image definitions for the host-uk ecosystem,
producing both Docker images and TIM bundles from a single source.

Images:
- developer: Full-fat dev environment with Claude Code CLI, PHP 8.4,
  Node.js, Go, Python, and 100+ tools (ghcr.io/host-uk/core-dev)
- server-php: Production Alpine + Nginx + PHP-FPM with multi-stage
  builds for dev/prod targets (ghcr.io/host-uk/server-php)

Includes:
- Taskfile for local builds (docker + tim)
- GitHub Actions workflow for multi-arch builds
- Borgfiles for future TIM bundle generation

Consolidates docker-developer and docker-server-php repositories.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-28 17:27:17 +00:00

1.6 KiB

core-images

Container images for the host-uk ecosystem. Each image produces dual outputs:

  • Docker imageghcr.io/host-uk/<name>
  • TIM bundle<name>-<os>-<arch>.tim

Images

Image Purpose Docker TIM
developer Full-fat dev environment (100+ tools) ghcr.io/host-uk/core-dev core-dev.tim
server-php Alpine + Nginx + PHP-FPM ghcr.io/host-uk/server-php server-php.tim

Usage

Docker

# Developer environment
docker run -it ghcr.io/host-uk/core-dev

# PHP server
docker run -p 80:80 ghcr.io/host-uk/server-php

TIM (Docker-free via Core)

# Install dev environment
core dev install

# Or run directly
core run core-dev.tim

# Run PHP server
core run server-php.tim -p 80:80

Building

# Requires: task (taskfile.dev)

# Build all
task build

# Build specific image
task build:developer
task build:server-php

# Build TIM only
task build:developer:tim

# Build Docker only
task build:developer:docker

Structure

core-images/
├── developer/           # core-dev.tim - Full dev environment
│   ├── Dockerfile
│   ├── Borgfile
│   └── config/
├── server-php/          # server-php.tim - Nginx + PHP-FPM
│   ├── Dockerfile
│   ├── Borgfile
│   └── config/
└── base/                # Shared base configurations
    └── alpine/

Sources

Consolidated from: