Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
R

rallyup

> 编程语言
Open source

rallyup is a lightweight Wake-On-LAN (WOL) scheduler and dependency manager designed for small businesses and homelabs.

361 stars0 likes1 views
WebsiteGitHub

About

rallyup is a lightweight Wake-On-LAN (WOL) scheduler and dependency manager designed for small businesses and homelabs.

rallyup

rallyup is a lightweight Wake-On-LAN (WOL) scheduler and dependency manager designed for small businesses and homelabs. It ensures that infrastructure services like firewalls, storage, and hypervisors are brought online in the correct order, particularly after events like power outages.

A typical setup involves configuring most of the infrastructure for WOL but not for Wake-On-Power, and setting rallyup to run on startup on a low-power device like a Raspberry Pi. When you need to bring the entire environment online, simply power on the device running rallyup, and the rest of the infrastructure will automatically follow in the correct order.

Features

  • VLAN Support: Send WOL packets to devices across different VLANs.
  • YAML Configuration: Easily define server boot sequences, dependencies, and status checks.
  • Service Status Checks: Verify that a service is up using built-in status checks (HTTP health checks, NFS, SMB, custom shell commands).
    • HTTP
    • Open port
    • Shell
    • NFS (might just use open port check)
    • SMB (might just use open port check)
  • Plugin-Friendly: Users can write their own custom status check plugins.

Usage

bash
rallyup servers.yaml

Configuration

The dependencies between servers, along with the methods for validating that they are online, are defined in a YAML configuration file.

Servers Configuration

Fields:

  • name: The name of the server, used for identification when defining dependencies between servers
  • mac: The MAC address of the server we want to wake up
  • interface: The network interface to use when sending the WOL packet
  • vlan: The VLAN ID (optional) that the server is on
  • depends: A list of other server names that this server depends on
  • check: A list of health checks that must pass before this server is considered fully online

Example:

yaml
- name: "firewall"
  mac: "00:11:22:33:44:55"
  interface: "eth0"
  vlan: 100
  depends:
    - "storage"
  check: [... see below]

Health Check Configurations

Each server can have multiple health checks to ensure the server is fully online before the next device starts up.

Common Fields

  • retry: The interval, defined in human readable string (e.g. 1s, 1 minute, etc.) to wait between retrying this health check
  • timeout: The timeout interval after which the check, and subsequently the entire boot sequence, will fail

Built-in Health Checks

HTTP Health Checks

The HTTP health check verifies whether a specified endpoint responds as expected.

Fields

  • type: should be http for an HTTP health check.
  • url: The URL to perform the HTTP health check against
  • status: Expected HTTP status code
  • regex: Regex to match in the response body

Note: You must provide either status or regex, or both.

Example

yaml
- type: http
  url: "http://192.168.1.1/health"
  status: 200
  retry: 5s
  timeout: 30s

Port Health Check

The port health check verifies whether a specified TCP port on a server is open and accessible. This is really a stand-in for verifying NFS and SMB ports until I can figure out how to check if those services are online.

Fields

  • type: should be port for a port health check
  • ip: the IP address to check
  • port: the port number to check

Example

yaml
- type: port
  ip: "192.168.1.1"
  port: 22
  retry: "10s"
  timeout: "1m"

Shell Health Checks

The shell health check executes a shell command checks the result. This is to provide the option of user-defined health checks.

Fields

  • type: should be shell for a shell health check.
  • command: he shell command to execute
  • status: Expected exit code
  • regex: Regex to match in the standard output

Note: You must provide either status or regex, or both.

Example

yaml
- type: shell
  command: ping -c 1 192.168.1.1
  status: 0
  retry: 5s
  timeout: 20s

Full Example

TODO:

  • Need to test in the lab and post the actual sample
…

License

This project is licensed under either of the following licenses, at your option:

  • MIT License
  • Apache License 2.0

You may choose to use this project under the terms of either license.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Rustautomationcommand-linecommand-line-toolhomelab

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言