https://github.com/merlinz01/redpepper

A state-based server management system
https://github.com/merlinz01/redpepper

client-server cms configuration-management iac infrastructure-as-code infrastructure-automation infrastructure-management linux python remote-execution server-management state-management web-ui

Last synced: 5 days ago
JSON representation

A state-based server management system

• Host: GitHub
• URL: https://github.com/merlinz01/redpepper
• Owner: merlinz01
• License: mit
• Created: 2024-05-16T19:14:15.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2026-02-28T16:11:23.000Z (11 days ago)
• Last Synced: 2026-02-28T19:26:38.964Z (11 days ago)
• Topics: client-server, cms, configuration-management, iac, infrastructure-as-code, infrastructure-automation, infrastructure-management, linux, python, remote-execution, server-management, state-management, web-ui
• Language: Python
• Homepage:
• Size: 2.02 MB
• Stars: 4
• Watchers: 1
• Forks: 1
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# RedPepper

[![GitHub license](https://img.shields.io/github/license/merlinz01/redpepper)](LICENSE.txt)

[![GitHub release](https://img.shields.io/github/v/release/merlinz01/redpepper)](https://github.com/merlinz01/redpepper/releases)

[![GitHub issues](https://img.shields.io/github/issues/merlinz01/redpepper)](https://github.com/merlinz01/redpepper/issues)

[![GitHub pull requests](https://img.shields.io/github/issues-pr/merlinz01/redpepper)](https://github.com/merlinz01/redpepper/pulls)

[![GitHub contributors](https://img.shields.io/github/contributors/merlinz01/redpepper)](https://github.com/merlinz01/redpepper/graphs/contributors)

[![Code coverage](https://codecov.io/github/merlinz01/redpepper/graph/badge.svg?token=UB5DDINFJQ)](https://codecov.io/github/merlinz01/redpepper)

![RedPepper logo](redpepper.png)

RedPepper is a state-based configuration management system written in Python.

It has two basic components: a central manager and one or more agents on controlled servers.

Redpepper is used to distribute configuration to servers and ensure that the servers remain in a consistent state.

RedPepper is inspired by [Salt](https://github.com/saltstack/salt) but aims to be more flexible and easy-to-use.

RedPepper has a REST API for integration with tools or user interfaces.

RedPepper comes with an integrated web UI built with [Vue.js](https://vuejs.org) for managing the system.

![Agents view](/console/demo_agents.png)

![Commands view](/console/demo_commands.png)

![Data editor view](/console/demo_dataeditor.png)

> Please note: This project is currently being beta-tested and the bugs are being worked out.

> You can help by testing RedPepper in your own use case and opening issues when you find a flat spot.

## Documentation

See .

## Installation

Installation scripts are provided in the `setup` directory.

See [Installation](docs/installation.md) for installation instructions.

## Usage

RedPepper's user interface is the RedPepper Console, which is installed with the Manager.

See [the documentation for the console](docs/console.md).

## Configuration

See [Configuration](docs/configuration.md) for more info.

### Sample state file

```yaml

- Nginx:

    - Packages:

        type: package.Installed

        name: nginx

    - Config file:

        type: file.Installed

        source: file-stored-on-manager.conf

        path: /etc/nginx/installed-by-redpepper.conf

        user: nginx

        group: nginx

        mode: 0600

        if:

          all:

            - py: not sys.platform.startswith('win')

            - not file exists: /some/other/file

    - Server running:

        type: service.Running

        name: nginx

```

## Security

RedPepper aims to be fully secure by default where possible.

See [SECURITY.md](SECURITY.md) and [Security Features](docs/security-features.md) for more info.

## License

RedPepper is licensed under the MIT license.