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:
- Services: static sites, Node.js, Go, Python and PHP, each supervised by the right process manager.
- Hosts: nginx or Apache virtual hosts generated from templates, validated before every reload.
- Certificates: Let's Encrypt, self-signed or your own, with wor keeping its own copy so a renewal cannot take the web server down.
- Data safety: source backups, database backups, and a rollback that backs up before it resets.
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 runManage 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|logsSSL
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|removeDeploy 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|backupBack up databases
MySQL/MariaDB, PostgreSQL, SQL Server and SQLite to gzip files. Backup only, by design: no restore, drop or migrate.
database add|remove|backupFind 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 infoPer-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 reloadDrive 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 --jsonUpdate itself
Compares against what the download site publishes and installs the newer release through the archive's own installer.
upgradeNavigate fast
wor goto myapp/api changes your shell into that service's folder.
path shell-initHow it fits together
sudo wor$WOR_HOME JSON configswor 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
| Platform | Role | State |
|---|---|---|
| Linux, Debian family (Debian 12+, Ubuntu LTS) | Production and development host | works, install.sh implemented |
| Linux, RHEL family (RHEL, Rocky, Alma, CentOS Stream 9+) | Production and development host | designed, not built installer stops with an error |
| macOS (Homebrew), arm64 and amd64 | Development host | works binary-only install |
| Windows | - | removed use WSL2 |
Where to read next
| If you want to... | Go to |
|---|---|
| install it and run it the first time | Install & first run (with a quick start) |
| understand domain, service and host, and the folder layout | Concepts |
| look up a command, with example output | Command reference |
| choose a template, tune PHP, add nginx snippets | Services & templates |
| set up HTTPS or debug a certificate | SSL & certificates |
| a site is down | Operations & recovery |
Project facts
| Module / language | wor, Go 1.21+ (go.mod), standard library only |
| License | Apache License 2.0. The name and logo are covered separately by TRADEMARK.md: modified builds must say they are modified. |
| Maintainer | Worapong Sriwichian |
| Downloads and public site | https://wor.worapong.com/download; the site source is in public/ |
| Origin | Go port of wor-cli v1 (bash). Config moved from module.exports JS to JSON. |