Operate¶
For the person who installs, upgrades and connects it.
Standing this up beside the MES a plant already runs? Start at Running FactorySemantics MES beside your existing MES — one page, in order, for a controls person and an IT person together. Every page below is linked from it.
| Page | Type |
|---|---|
| Beside your existing MES | tutorial — the whole path, one afternoon, for a plant engineer |
| Deploy | tutorial — Compose on one box, or systemd units for test and promoted environments |
| Run it on your own box | how-to — the first hour on a PC of your own: PATH on Windows, is it still running, and a plant left alive but silent |
| Connecting read-only to an OPC UA server you do not own | how-to — commissioning against a server that already serves another system |
| Plant packs | reference — the one directory that says which plant this is |
| Plants from a fleet file | how-to — several independent plants, one list |
| How much of the window did the MES see | explanation — the coverage ledger: every second of an OEE window, and the KPI a plant can withhold |
| Running beside an existing MES | how-to — shadow mode: one setting, and this MES can change nothing in the plant |
| The ERPNext connector | how-to |
| The unified namespace (MQTT) | how-to — MES events onto a plant's broker |
| Backup and restore | how-to — what to copy, and how to prove the copy is any good |
| TLS in front of the API | how-to — the reverse proxy, in one config each |
| Upgrading between versions | how-to — the procedure, the rollback, and the gap |
| Feeding the MES what people typed elsewhere | how-to — downtime labels, quality results and counts from another system, by file or by read-only query |
| Settings | reference, generated |
| CLI | reference, generated |
| REST API | reference, generated |
| What to expect in the first week | explanation — what a shadow run gets wrong at first, and what is worth comparing |
| Compatibility | explanation — what has been tested against what, honestly |
| Security | explanation — threat model, lab defaults, what not to expose |
Not written yet (as of 2026-09-10): a Node-RED example flow over the unified namespace. Ask in Discussions; a question asked twice becomes a page.