Introducing g2rudder

Accessing a REST API without the proper tools is often bothersome, especially when you only have a shell and curl at hand - like in a kickstart %post part - and parsing JSON replies or building parameters can quickly become a mess.
g2rudder is here to help you cope with that issue in the form of a gateway written in Go that let's you use Rudder's API easily in a consistent way.


  • Support Rudder server over HTTPS
  • Can disable SSL verification and/or provide a root CA certificate
  • Groups:
    • Add hosts in Rudder groups
    • Automatically add regex if provided host contains the following characters: *[]|
  • Hosts:
    • Check if hostname is pending
    • Check if hostname exists
    • Get node uuid from hostname
    • Accept pending node from hostname
    • Add/delete properties


curl -X POST http://localhost:8181/group/addHost -d "g_uuid=5af30b6b-c8cd-4405-9d0c-410c2b05e220&"

curl -X GET http://localhost:8181/host/isExist?
curl -X GET http://localhost:8181/host/isPending?
curl -X GET http://localhost:8181/host/getId?
curl -X POST http://localhost:8181/host/addProperty -d ""
curl -X POST http://localhost:8181/host/delProperty -d ""
curl -X POST http://localhost:8181/host/accept -d ""

Project readme will be updated along with the addition of new features.
Don't hesitate to contact me if you encounter any issue.