FiveM RCON Docker image (lightweight, on-demand, CI/CD friendly)

Why this exists (aka desperation-driven development)

After fighting with various RCON setups in CI/CD, Docker Swarm and GitOps workflows, I finally gave up and created my own lightweight RCON client as a Docker image.

The main problem I wanted to solve:

  • :x: long-running RCON sidecars
  • :x: keeping RCON credentials alive 24/7
  • :x: insecure setups where RCON is always reachable
  • :x: ugly shell hacks inside pipelines

So this image is intentionally one-shot & stateless.

It runs only when needed, sends a command, exits.
No daemon. No open socket sitting around.


What it is

  • Tiny UDP RCON client (Quake 3 style packet format, used by FiveM)
  • Docker-first
  • Designed for:
    • CI/CD pipelines (GitHub Actions / GitLab CI)
    • GitOps workflows
    • Docker / Docker Swarm / Kubernetes Jobs
  • No dependencies, no runtime overhead

What it is NOT

  • :x: Not a replacement for in-game admin tools
  • :x: Not a persistent RCON service
  • :x: Not meant to be exposed publicly

This is automation glue, not an admin panel.


Typical use cases

  • Scheduled server announcements
  • CI-triggered admin commands
  • Controlled restarts / kicks
  • Maintenance messages
  • GitOps-driven server operations

All without keeping RCON permanently online.


Links


If someone already solved this in a cleaner way — I’d love to see it.
Otherwise maybe this helps someone who’s also tired of duct-taping RCON into pipelines :smile:

Feedback welcome.