Install KoroERP as Native Binaries
No Docker, no containers, no daemon. Every service is a single static executable managed by systemd, launchd or Windows Services.
Why go binary?
KoroERP ships every Go service as a static, dependency-free executable — the exact same binary that runs inside our Docker images.
Tiny footprint
One static Go binary per service (~20–50 MB). Runs comfortably on 1 GB VPS or Raspberry Pi.
Docker-free
No daemon, no images, no registry. Works in air-gapped and regulated environments where Docker is restricted.
OS-native services
Managed by systemd on Linux, launchd on macOS, and Windows Services on Windows.
Edge-friendly
Perfect for remote deployments where a full container runtime is overkill.
Instant start
Cold-start in tens of milliseconds. No image pulls, no layer extraction.
Same binary in prod
The exact same binary that runs in Docker also runs bare-metal.
Requirements
Server
Any Linux distro, macOS 12+, or Windows Server 2019+
RAM
1 GB minimum (2 GB+ recommended). Binaries use ~20–50 MB each
Disk
2 GB free space for binaries + logs
Database
Existing PostgreSQL 14+ reachable from the host
Redis
Optional — only needed if you enable the Lookups cache
Perms
root / sudo (Linux) or Administrator (Windows) for service registration
One-Line Install
The installer downloads every service binary for your OS/arch, generates RSA keys, writes a shared koro.env, and registers all services.
curl -fsSL https://koroworks.com/deploy/install-binaries.sh | sudo KORO_BINARY_MIRROR=https://koroworks.com/binaries bashServices Installed
30 Go services. All bind to 127.0.0.1 by default; only the gateway (:7009) is published externally.
Manual Install
1. Get the current release version
curl -fsSL https://koroworks.com/binaries/VERSION2. Download a single service binary
VERSION=$(curl -fsSL https://koroworks.com/binaries/VERSION)
curl -fsSL -o koro-gateway.tar.gz \
https://koroworks.com/binaries/linux/amd64/koro-gateway-${VERSION}-linux-amd64.tar.gz
tar -xzf koro-gateway.tar.gz
chmod +x koro-gateway3. Download all binaries at once
VERSION=$(curl -fsSL https://koroworks.com/binaries/VERSION)
for svc in auth hrm notifications scm manufacturing crm sales project-management accounting gateway logs ecommerce pos payment-gateway documents marketing compliance agriculture lookups ngo logistics healthcare lms chat licence service-desk bsc party wellness monitor; do
curl -fsSL "https://koroworks.com/binaries/linux/amd64/koro-${svc}-${VERSION}-linux-amd64.tar.gz" | tar -xz
done4. Install the web UI (separate step)
The binary installer sets up backend services + gateway only. It does not install the ERP web frontend automatically.
- Option A (recommended): run the prebuilt web container (web-business) from theOn-Prem guide, and point it to your gateway via API_BASE_URL(this variable is for the ERP web frontend deployment, not this static marketing site).
- Option B: build and host the Flutter web frontend yourself (Nginx/Caddy), then configure it to call your gateway URL.
With binaries, users can still use desktop/mobile apps immediately while you finish web hosting.