docs/deploy/index.md
Snider 85bbb8e828 docs: initial import of CorePHP documentation
173 markdown files covering:
- Framework architecture (lifecycle events, module system, multi-tenancy)
- Package docs (admin, api, mcp, tenant, commerce, content, developer)
- CLI reference (dev, build, go, php, deploy commands)
- Patterns (actions, repositories, seeders, services, HLCRF)
- Deployment (Docker, PHP, LinuxKit, templates)
- Publishing (Homebrew, AUR, npm, Docker, Scoop, Chocolatey)

Source: core-php/docs (core.help content)

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-03 17:51:03 +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.