php/docs/deploy/index.md
Snider 28d004ff61
Some checks failed
CI / PHP 8.4 (push) Failing after 1m54s
CI / PHP 8.3 (push) Failing after 1m58s
feat: replace Go CLI with PHP framework
Go CLI commands moved to core/go-php. This repo now contains
the Laravel modular monolith framework (previously php-framework).

- Remove all Go files (now in core/go-php)
- Add PHP framework: event-driven module loading, lifecycle events
- Composer package: core/php
- core/php-framework remains as-is for backward compat

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-06 08:49:51 +00:00

2.8 KiB

Deploy

Deploy applications to VMs, containers, and cloud infrastructure.

Deployment Options

Target Description Use Case
PHP Laravel/PHP with FrankenPHP Web applications, APIs
LinuxKit Lightweight immutable VMs Production servers, edge nodes
Templates Pre-configured VM images Quick deployment, dev environments
Docker Container orchestration Kubernetes, Swarm, ECS

Quick Start

Run a Production Server

# Build and run from template
core vm run --template server-php --var SSH_KEY="$(cat ~/.ssh/id_rsa.pub)"

# Or run a pre-built image
core vm run -d --memory 4096 --cpus 4 server.iso

Deploy to Docker

# Build and push image
core build --type docker --image ghcr.io/myorg/myapp --push

# Deploy with docker-compose
docker compose up -d

Architecture

┌─────────────────────────────────────────────────────────┐
│                    Build Phase                          │
│  core build → Docker images, LinuxKit ISOs, binaries   │
└─────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────┐
│                   Publish Phase                         │
│  core ci → GitHub, Docker Hub, GHCR, Homebrew, etc.    │
└─────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────┐
│                   Deploy Phase                          │
│  core vm → LinuxKit VMs, templates, orchestration      │
└─────────────────────────────────────────────────────────┘

CLI Commands

Command Description
core vm run Run a LinuxKit image or template
core vm ps List running VMs
core vm stop Stop a VM
core vm logs View VM logs
core vm exec Execute command in VM
core vm templates Manage LinuxKit templates

See the CLI Reference for full command documentation.