No description
69d293dd23
Some checks are pending
Build Images / Docker (developer) (push) Waiting to run
Build Images / Docker (server-php) (push) Waiting to run
Build Images / LinuxKit (developer-amd64) (push) Blocked by required conditions
Build Images / LinuxKit (server-php-amd64) (push) Blocked by required conditions
Build Images / LinuxKit (developer-arm64) (push) Blocked by required conditions
Build Images / LinuxKit (server-php-arm64) (push) Blocked by required conditions
Build Images / Release LinuxKit Images (push) Blocked by required conditions
Comprehensive developer image with all S4.6 tooling: AI/LLM: claude, aider, llm VCS: git, gh, lazygit, delta, git-lfs Runtimes: node, bun, deno, go, python3, rustc, frankenphp Package Mgrs: npm, pnpm, yarn, composer, pip, uv, cargo Build: task, just, make, turbo, nx Linting: pint, phpstan, prettier, eslint, biome, golangci-lint, ruff Testing: phpunit, pest, vitest, k6 Infra: docker, kubectl, k9s, helm, terraform, ansible Databases: sqlite, mysql, psql, redis-cli, usql HTTP/Net: curl, httpie, xh, websocat, grpcurl, mkcert Data: jq, yq, fx, gron, miller, dasel Security: age, sops, cosign, trivy, trufflehog Monitoring: htop, btop, ctop, lazydocker, dive Files: fd, rg, fzf, bat, eza, tree, zoxide, broot Editors: nvim, helix, vim, nano Includes shell config (zsh + oh-my-zsh + starship), tmux, and comprehensive aliases for all tools. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .github/workflows | ||
| developer | ||
| linuxkit | ||
| server-php | ||
| .gitignore | ||
| README.md | ||
| Taskfile.yaml | ||
core-images
Container images for the host-uk ecosystem. Each image produces multiple outputs:
- Docker image →
ghcr.io/host-uk/<name> - LinuxKit image →
<name>-<arch>.qcow2/<name>-<arch>.iso - TIM bundle →
<name>-<os>-<arch>.tim(future)
Images
| Image | Purpose | Docker | LinuxKit |
|---|---|---|---|
developer |
Full-fat dev environment (100+ tools) | ghcr.io/host-uk/core-dev |
core-dev-amd64.qcow2 |
server-php |
Alpine + Nginx + PHP-FPM | ghcr.io/host-uk/server-php |
server-php-amd64.qcow2 |
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
LinuxKit (via Core CLI)
# Build LinuxKit image
core build --type linuxkit --config developer/linuxkit.yml
# Run LinuxKit image
core run core-dev-amd64.qcow2
# Run with custom resources
core run core-dev-amd64.qcow2 --memory 4096 --cpus 4
TIM (future, Docker-free)
# Install dev environment
core dev install
# Run directly
core run core-dev.tim
# Run PHP server
core run server-php.tim -p 80:80
Building Locally
Using Core CLI (recommended)
# Install core CLI
go install github.com/host-uk/core/cmd/core@latest
# Build LinuxKit images
core build --type linuxkit --config developer/linuxkit.yml --format qcow2-bios
core build --type linuxkit --config server-php/linuxkit.yml --format qcow2-bios
# Build Docker images
core build --type docker --config developer/Dockerfile
core build --type docker --config server-php/Dockerfile
Using Task
# Requires: task (taskfile.dev)
# Build all
task build
# Build specific image
task build:developer
task build:server-php
Structure
core-images/
├── developer/ # core-dev - Full dev environment
│ ├── Dockerfile # Docker build
│ ├── linuxkit.yml # LinuxKit build
│ ├── Borgfile # TIM build (future)
│ └── config/
├── server-php/ # server-php - Nginx + PHP-FPM
│ ├── Dockerfile
│ ├── linuxkit.yml
│ ├── Borgfile
│ └── config/
└── linuxkit/ # LinuxKit documentation
└── README.md
CI/CD
The GitHub Actions workflow builds:
- Docker images - Multi-arch (amd64, arm64) pushed to GHCR
- LinuxKit images - qcow2 and ISO formats for both architectures
- Release artifacts - LinuxKit images uploaded to GitHub Releases on tags
All builds use the core CLI for consistency.
Sources
Consolidated from: