Keelan Engine is a minimalist container engine built from scratch.
No daemons. No virtualization modules. No overhead.
Run multiple isolated apps on a single VPS with zero conflict and near-zero cost.
Build your own tools. Run them your way.
Keelan Engine isn't here to replace Docker.
It's for devs who want to understand everything they run — down to the filesystem.
Every crate is a portable, isolated root filesystem.
Every ship is a live process.
No cgroups. No kernel modules. Just you and the system.
- ⚡ Ultra-fast builds and execution (<100ms startup)
- 📦 No dependency conflicts – each app has its own rootfs
- 🧱 Custom syntax via
Keelanfile.yml - 🧊 Zero overhead – no daemons, no idle RAM usage
- 🛠️ Designed for VPS & low-resource systems
# Keelanfile.yml
build_context:
base_image: "debian"
work_directory: "/app"
build_steps:
- action: execute_command
description: "Update apt"
command: ["apt-get", "update", "-y"]
- action: execute_command
description: "Install Python pip"
command: ["apt-get", "install", "-y", "python3-pip"]
crate_config:
expose_ports: [8000]
environment_variables:
PORT: "8000"
runtime_command: ["python3", "-m", "http.server", "8000"]# Build a crate from a directory with Keelanfile.yml
keelan build -w <directory> -n <name>
# Deploy the container (a.k.a. ship)
keelan ship deploy <name>
# List all crates and ships
keelan list
# Remove a crateEach ship runs in its own environment using OverlayFS and chroot.
It feels like Docker, but runs like native.
-
Clone this repository:
git clone <repository-url> cd shipper
-
Make install.sh executable:
chmod +x install.sh
-
Run install.sh:
./install.sh
- Personal VPS hosting
- CI sandboxing
- Local experiments
- Embedded systems
- Linux with OverlayFS support
- Node.js 22+ and npm (recommended: Node.js 22, Node.js 24 has known issues with better-mysql3)
- Must run on bare metal (not inside Docker, chroot, or proot environments)
- Root privileges required for all commands
- No Docker required. No kernel modules.
- 🚀 Quick Start Guide - Get running in 5 minutes
- 📋 Complete Documentation - Comprehensive project guide
- 🔧 API Reference - Technical API documentation
- ⚙️ Daemon System - Background monitoring guide
This project is mostly built for personal use — but PRs are welcome if they align with the minimalist philosophy.
Licensed under the Apache 2.0 License
"When you build it yourself, you control everything."
— Keelan Engine