xyOps

xyOps

Docker app from xyOps' Repository

Overview

xyOps is a self-hosted operations automation platform for job scheduling, visual workflows, server monitoring, alerting, tickets, and incident response.

Readme

View on GitHub

xyOps Unraid Community Apps Template

This repository contains the Unraid Community Apps template for xyOps, a self-hosted operations automation platform for job scheduling, visual workflows, server monitoring, alerting, tickets, snapshots, and incident response.

The template uses the official Docker image:

ghcr.io/pixlcore/xyops:latest

Files

  • ca_profile.xml: Repository metadata shown by Community Apps.
  • templates/xyops.xml: Docker template for the xyOps conductor container.
  • icon.png: Repository and app icon used by the template.
  • LICENSE: BSD-3-Clause license text.

There is no Unraid plugin wrapper in this repository. xyOps is submitted as a Docker application.

Template Defaults

The Docker template includes:

  • Web UI/API port 5522, which satellites use by default.
  • Optional built-in HTTPS/TLS web port 5523.
  • Persistent appdata mounts for:
    • /opt/xyops/data
    • /opt/xyops/conf
    • /opt/xyops/logs
  • Docker socket mount:
    • /var/run/docker.sock:/var/run/docker.sock
  • XYOPS_xysat_local=true so first-run installs have a local worker available.
  • A default Docker hostname of xyops.
  • Editable XYOPS_hostname, XYOPS_masters, and XYOPS_base_app_url fields.

Important User Settings

Before adding remote workers, users should change both Conductor Hostname and Conductor Masters to a stable hostname that resolves on their network. For a single-conductor Unraid install, these should usually be the same value.

Users should also set Base App URL to the address people use to open xyOps, for example:

http://tower.local:5522

xyOps uses this URL when it creates links in emails, tickets, alerts, and web hook payloads.

xyOps docs:

Requirements

A stable hostname or DNS name is recommended for remote workers. Docker socket access is required for xyOps to launch containers.

Categories

Tools > System

Related apps

Explore more like this

Explore all
System apps

Links

Projectgithub.comSupportgithub.comRegistrygithub.comTemplateraw.githubusercontent.com

Details

Repository
ghcr.io/pixlcore/xyops:latest
Registry
https://github.com/pixlcore/xyops/pkgs/container/xyops
Last Updated2026-10-07
First Seen2026-07-05

Runtime arguments

Web UI
http://[IP]:[PORT:5522]
Network
bridge
Shell
bash
Privileged
false
Extra Params
--hostname xyops

Template configuration

HTTP PortPorttcp

HTTP port for the xyOps web UI, API, and default satellite communication.

Target
5522
Default
5522
HTTPS PortPorttcp

Built-in HTTPS/TLS port for the xyOps web UI. xyOps ships with a snakeoil certificate, so generate and configure a real certificate before relying on this for production.

Target
5523
Default
5523
DataPathrw

Persistent xyOps database and file storage.

Target
/opt/xyops/data
Default
/mnt/user/appdata/xyops/data
ConfigurationPathrw

Persistent xyOps configuration, including config.json, overrides.json, masters.json, and the generated secret key.

Target
/opt/xyops/conf
Default
/mnt/user/appdata/xyops/conf
LogsPathrw

Persistent xyOps logs and startup hostname tracking.

Target
/opt/xyops/logs
Default
/mnt/user/appdata/xyops/logs
Docker SocketPathrw

Allows xyOps to launch and manage containers for the Docker Plugin and Plugin Marketplace.

Target
/var/run/docker.sock
Default
/var/run/docker.sock
Conductor HostnameVariable

Stable hostname xyOps uses as its conductor identity. Change this to a DNS name reachable by xyOps workers and job containers.

Target
XYOPS_hostname
Default
xyops
Conductor MastersVariable

Comma-separated conductor hostnames. For a single Unraid install, keep this the same as Conductor Hostname.

Target
XYOPS_masters
Default
xyops
Base App URLVariable

User-facing URL used in email links, tickets, alerts, and web hooks. Set this to the address people use to open xyOps.

Target
XYOPS_base_app_url
Default
http://xyops:5522
Local xySatVariable

Starts a local xySat worker inside the conductor container for home labs and first-run testing.

Target
XYOPS_xysat_local
Default
true
TimezoneVariable

Timezone used for daily log rotation and statistics resets.

Target
TZ
Default
Etc/UTC
Node Max MemoryVariable

Maximum Node.js old-space heap size in MB for the xyOps conductor process.

Target
NODE_MAX_MEMORY
Default
4096