{"id":13640121,"url":"https://github.com/normation/rudder","last_synced_at":"2025-12-17T19:59:44.905Z","repository":{"id":37405586,"uuid":"2528254","full_name":"Normation/rudder","owner":"Normation","description":"Rudder is a configuration and security automation platform. Manage your Cloud, hybrid or on-premises infrastructure in a simple, scalable and dynamic way.","archived":false,"fork":false,"pushed_at":"2024-04-12T15:33:59.000Z","size":72238,"stargazers_count":495,"open_issues_count":33,"forks_count":74,"subscribers_count":24,"default_branch":"master","last_synced_at":"2024-04-12T23:37:42.967Z","etag":null,"topics":["auditing","automation","compliance","configuration-management","continous-auditing","continuous-configuration","devops"],"latest_commit_sha":null,"homepage":"https://www.rudder.io","language":"Scala","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Normation.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":"CONTRIBUTING.adoc","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.adoc","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2011-10-06T19:27:50.000Z","updated_at":"2024-04-15T08:36:57.066Z","dependencies_parsed_at":"2023-10-02T08:45:07.799Z","dependency_job_id":"fc18250c-8131-4997-8494-c45de76b877a","html_url":"https://github.com/Normation/rudder","commit_stats":null,"previous_names":[],"tags_count":827,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Normation%2Frudder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Normation%2Frudder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Normation%2Frudder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Normation%2Frudder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Normation","download_url":"https://codeload.github.com/Normation/rudder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223816395,"owners_count":17207851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auditing","automation","compliance","configuration-management","continous-auditing","continuous-configuration","devops"],"created_at":"2024-08-02T01:01:07.952Z","updated_at":"2025-12-17T19:59:44.866Z","avatar_url":"https://github.com/Normation.png","language":"Scala","readme":"= Rudder: Continuous Auditing \u0026 Configuration\n\nimage::logo/rudder-logo-rect-black.svg[Rudder]\n\nimage:https://img.shields.io/badge/chat-with the community-brightgreen.svg?style=flat[link=\"https://docs.rudder.io\"]\nimage:https://img.shields.io/badge/read-the documentation-green.svg?style=flat[link=\"https://docs.rudder.io\"]\nimage:https://img.shields.io/badge/open-an issue-blue.svg?style=flat[link=\"https://issues.rudder.io\"]\nimage:https://img.shields.io/badge/visit-our website-blueviolet.svg?style=flat[link=\"https://issues.rudder.io\"]\nimage:https://img.shields.io/badge/donate-to support development-yellow.svg?style=flat[link=\"https://salt.bountysource.com/teams/rudder\"]\nimage:https://img.shields.io/twitter/follow/rudderio.svg?style=social[link=\"https://twitter.com/rudderio\"]\n\nRudder is an easy to use, web-driven, role-based solution for IT Infrastructure Automation \u0026 Compliance.\n\nimage::readme-resources/dashboard.png[Rudder Dashboard]\n\n'''\n\n* Rudder is made of several components:\n\n** A *central server* (written in Scala) that defines the configurations to apply and collects application reports, with a focus on *continuously checking configurations* and centralising real-time status data. A *graphical builder* lowers the technical level required to define policies. Each policy can be independently set to be automatically *checked or enforced* on a policy or host level.\n\n** *Agents* installed on the managed nodes. As they are *very lightweight* (10 to 20 MB of RAM at peak) and blazingly fast (they are written in C and takes less than 10 seconds to verify 100 rules), they *run on almost every kind of device*, so you’ll be managing physical and virtual servers in the data center, cloud instances, and embedded IoT devices in the same way. Installation is self-contained, via a single package, and can auto-update to limit agent management burden.\n\n** *Relay servers* (optional) that allows managing nodes in different networks, or on different site through a single entry point.\n\n* Rudder is designed for *critical environments* where a security breach can mean more than a blip in the sales stats. Built-in features include change requests, audit logs, and strong authentication.\n\n* The workflow offers different users options at their own level:\n\n** *Non-expert users* can define parameters in a central interface, and Rudder will automatically make sure that your IT services are installed, configured, running and in good health. All actions (checks, warnings, fixed errors…) are reported upon immediately in the user interface, keeping drift from nominal behaviour low.\n** *Expert users* can configure how to implement these parameters on different systems, or build upon the pre-defined library provided using the CLI or API.\n** *Managers* can consult compliance reports and access audit logs.\n\nRudder is an established project with several *tens of thousands of managed nodes*, in companies from small to biggest-in-their-field. Typical deployments manage 100s to 1000s of nodes. The biggest known deployments are about 10k nodes on a single Rudder server.\n\n→ Read more about Rudder features https://www.rudder.io/en/discover/what-is-rudder/[on our website].\n\n== Test Rudder\n\n* You can try a https://demo.rudder.io[demo version of Rudder web interface] with fake nodes and compliance data.\n* *Get started* with a https://docs.rudder.io/get-started/current/index.html[step-by-step guide] to setup a test environment and learn how to configure simple rules!\n* *Get in touch*: if you encounter any problem while testing or have any question, *https://chat.rudder.io[come chat with the community]*!\n\n== Installation\n\nThe easiest way to test and use Rudder for prototyping or production is to install it from the provided Linux packages.\nFor the *server*, the main current .rpm-based (Red Hat, CentOS, SLES) and .deb-based\n(Debian, Ubuntu) distributions are supported.\n\nRudder *agent* is extremely versatile and packages are available for a wide range of\nversions of RedHat, CentOS, SLES, Debian and Ubuntu (like RHEL3 or Debian\nLenny). It works on other distributions as well, like Slackware, Raspbian and other\nembedded Linux on ARM/x86, FreeBSD but no ready-to-use packages are provided today).\n\nSupport for AIX, Solaris and Windows agents is provided as part of https://www.rudder.io/en/pricing/subscription/[Rudder subscription].\n\nTo install Rudder:\n\n* Read about the https://docs.rudder.io/reference/current/installation/operating_systems.html[compatible operating systems] and the https://docs.rudder.io/reference/current/installation/requirements.html[requirements] before starting\n* For a quick installation, we provide an https://docs.rudder.io/reference/current/installation/quick_install.html[automated installation script]\n* For a complete installation, follow the https://docs.rudder.io/reference/current/installation/server/debian.html[documentation]\n\n== Links\n\n[horizontal]\nWebsite:: https://www.rudder.io\nDocumentation:: https://docs.rudder.io\nAPI documentation:: https://docs.rudder.io/api\nChat:: https://chat.rudder.io\nBug report:: https://issues.rudder.io/projects/rudder/issues\nSource:: https://github.com/Normation/rudder\n\n== Contribute\n\nThank you for your interest in our project! We welcome pull requests on any of the Rudder repositories.\n\nThe contribution process is detailed here: https://www.rudder.io/en/expand/contribute/\n\nRudder is composed of https://www.rudder.io/en/expand/contribute/#panel-2422-6-0-0[several sub-projects]. The contribution process is detailed https://www.rudder.io/en/expand/contribute/[on our website].\n\n== Rudder components and projects overview\n\n=== Functional Components\n\nimage::readme-resources/rudder-functional-component-diagram.png[Rudder Functional Components]\n\n=== Projects\n\nRudder is composed of several repositories:\n\n|====\n|Component | Description and Repositories\n\n| Rudder documentation |\nWe have a dedicated project for Rudder main documentation:\nhttps://github.com/Normation/rudder-doc\n\n| Rudder agent |\nThis project contains the CLI for Rudder agent\nhttps://github.com/Normation/rudder-agent\n\n| Rudder configuration policies |\nProvided techniques coming in the base set-up of Rudder\nhttps://github.com/Normation/rudder-techniques\n\nThe structured configuration framework used to build Rudder techniques\nhttps://github.com/Normation/ncf\n\n| Rudder server |\nThis is the Scala web application responsible for policy definition and\ngeneration by node, and compliance reporting. It also manages node\ninventories.\nhttps://github.com/Normation/rudder\n\n| Rudder packages |\nThis project contains all the logic to build both server and agent packages for Rudder\nhttps://github.com/Normation/rudder-packages\n\n| Rudder tools |\nNice tools around Rudder, including various user-contributed scripts.\nhttps://github.com/Normation/rudder-tools\n\n| Rudder plugins |\nhttps://github.com/Normation/rudder-plugins\nhttps://github.com/Normation/rudder-plugin-itop\n\n|====\n\n== Authors\n\nRudder is supported by https://www.rudder.io/en/company/about-us/[Normation].\n\nThe list of contributors is available in https://github.com/Normation/rudder/graphs/contributors\n\n== License\n\nThis project is licensed under GPLv3 license, see the provided https://github.com/Normation/rudder/blob/master/LICENSE[LICENSE] (or\nits http://www.gnu.org/licenses/gpl-3.0.txt[source]).\n\nWe added an extension to the main GPLv3 license to allows to build and use plugins\non top of Rudder with any license, open source or closed/proprietary, see the https://github.com/Normation/rudder/blob/master/LICENSE_EXCEPTION[LICENSE_EXCEPTION].\n","funding_links":[],"categories":["Projects"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnormation%2Frudder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnormation%2Frudder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnormation%2Frudder/lists"}