Self-hosted edition

Installing ORDSwatch on your server

The self-hosted edition runs entirely on your own infrastructure: the ORDSwatch server (dashboard, alerting, license) on one machine, and a small agent on each Oracle REST Data Services server. Both come as RPM packages that carry everything they need — no Node.js, Java or other runtime to install.

Check System requirements first. In short: RHEL, Oracle Linux, Rocky or AlmaLinux 8 or 9 on x86_64, 1 GB free memory, and outbound HTTPS to the license server.

1. Install the server package

sudo dnf install ./ords-monitor-*.x86_64.rpm

The package creates a ords-monitor system account, starts the ords-monitor service, enables it at boot, and prints the address to open and a setup code:

  ORDSwatch is installed and running.
  Finish setup in your browser:   http://your-server:3000/setup
  Setup code:                     7Q4K-M2XD

Keep the setup code — the browser asks for it once, so only the person who installed the server can finish the setup. If it scrolled away:

sudo journalctl -u ords-monitor | grep "Setup code"

2. Open the port

The server listens on TCP 3000. Open it for your users' browsers and for the agents:

sudo firewall-cmd --add-port=3000/tcp --permanent && sudo firewall-cmd --reload

For production, put the server behind your existing reverse proxy (nginx, Apache httpd or a load balancer) with HTTPS, and open only the proxy's port. Forward X-Forwarded-Proto so sign-in cookies are marked secure.

With SELinux enforcing (the default — leave it on), allow the proxy to connect to ORDSwatch once; the installer reminds you if it is needed:

sudo setsebool -P httpd_can_network_connect 1

Nothing else about ORDSwatch needs SELinux changes — see System requirements.

3. Finish setup in the browser

Open http://your-server:3000/setup and continue with First-time setup and your license.

Where things are