WOR Hostdocumentation v1.0.5 Home Downloads

WOR Host

A host manager for Linux and macOS: deploy and run static, Node.js, Go, Python and PHP services behind nginx or Apache, with SSL certificates, database backups and incident tooling, all under one directory convention.

What it is

wor (product name WOR Host) is a command-line host manager written in Go. One static binary, standard library only. It is a from-scratch port of an earlier bash CLI (wor-cli v1) whose command surface it keeps as close as possible.

It manages four things on a Linux server or a macOS development machine, all under a single directory convention rooted at $WOR_HOME:

What it can do

Create and run services

Five templates: static, node, go, python, php. Scaffolds a starter tree, registers it, starts it under PM2, systemd or PHP-FPM.

create service add|start|stop|restart|status|logs run

Manage hosts

Generates nginx or Apache vhosts, enables them, tests the whole config, and reloads only if it passes. Rolls back otherwise.

host add|remove|list|test|reload|logs

SSL

Let's Encrypt (certbot webroot), self-signed, or custom. Per-host HTTP to HTTPS redirect. Auto-refresh hook.

ssl issue|renew|sync|redirect|status|install|remove

Deploy and roll back

Pull, install dependencies if the manifest changed, build, restart, health-check. Rollback hard-resets to origin/<branch> after a backup.

deploy rollback source clone|pull|backup

Back up databases

MySQL/MariaDB, PostgreSQL, SQL Server and SQLite to gzip files. Backup only, by design: no restore, drop or migrate.

database add|remove|backup

Find what is broken

A fleet-wide health sweep with one real HTTP request per service, then a read-only root-cause analysis for one target, with fix commands you run yourself.

health diagnose doctor info

Per-service tuning

Drop web-server snippets and PHP settings into a service's own .wor/ folder. They survive every regeneration.

.wor/nginx .wor/php.ini service reload

Drive it from a program

--json on four read-only reports, --non-interactive everywhere, and exit codes that work with cron.

version|doctor|health|ssl status --json

Update itself

Compares against what the download site publishes and installs the newer release through the archive's own installer.

upgrade

Navigate fast

wor goto myapp/api changes your shell into that service's folder.

path shell-init

How it fits together

Youoperator account, never sudo wor
→
worone Go binary
→
State$WOR_HOME JSON configs
→
Generatedvhosts, pool files, units, ecosystem files
→
Tools it drivesnginx/apache, PM2, systemd, php-fpm, certbot, git, db clients

wor does not run as a daemon. Each invocation reads the JSON state, takes a workspace lock if it writes, makes the change through the real tool, and exits. wor asks for sudo itself, once, and only for the operations that need it.

Platforms at a glance

PlatformRoleState
Linux, Debian family (Debian 12+, Ubuntu LTS)Production and development hostworks, install.sh implemented
Linux, RHEL family (RHEL, Rocky, Alma, CentOS Stream 9+)Production and development hostdesigned, not built installer stops with an error
macOS (Homebrew), arm64 and amd64Development hostworks binary-only install
Windows-removed use WSL2

Where to read next

If you want to...Go to
install it and run it the first timeInstall & first run (with a quick start)
understand domain, service and host, and the folder layoutConcepts
look up a command, with example outputCommand reference
choose a template, tune PHP, add nginx snippetsServices & templates
set up HTTPS or debug a certificateSSL & certificates
a site is downOperations & recovery

Project facts

Module / languagewor, Go 1.21+ (go.mod), standard library only
LicenseApache License 2.0. The name and logo are covered separately by TRADEMARK.md: modified builds must say they are modified.
MaintainerWorapong Sriwichian
Downloads and public sitehttps://wor.worapong.com/download; the site source is in public/
OriginGo port of wor-cli v1 (bash). Config moved from module.exports JS to JSON.