Builder CI

# Builder CI

Builder CI is an automated build system designed to support Continuous Integration (CI) across various types of development projects. It was created with the goal of simplifying and automating build pipelines in a more efficient way than traditional tools like Jenkins.

It’s designed to optionally integrate with [Redmine](https://www.redmine.org/) via a [dedicated plugin](https://github.com/iabsis/redmine-builder-ci), allowing better visibility into builds directly within project management workflows.

![Screenshot](https://raw.githubusercontent.com/iabsis/builder-ci/master/doc/builder-ci.png)

---

## Features

- Create any script to create your package (e.g., `.deb`, `.rpm`)

- Exposes a REST API to trigger builds

- Modular and extensible — build your own flow

- Lightweight: built with Python and minimal dependencies

- Easy to install and update with a single command on Debian Bookworm

- Uses PostGreSQL, Django and Podman.

- Commands are run in container for more safety.

- "Build as Code": configure builds using a `builder.yml` file

- Trigger multiple flow in one commit

- Automatic podman container build, based on advance rules

---

## Installation Guide (Takes ~2 Minutes)

> Note: All commands should be run as `root`.

---

### Install Builder CI (Debian Bookworm)

```bash

echo "deb [trusted=yes] https://projects.iabsis.com/repository/builder-ci/debian bookworm main" > /etc/apt/sources.list.d/iabsis.list

apt update && apt install builder-ci postgresql redis nginx

```

This will return error since database is not yet configured, ignore for now and go to next step

---

### Configure database

```bash

su - postgres

createuser --pwprompt builder

createdb -O builder builder

```

### Configure Builder CI

Now edit `/etc/builder-ci/builder-ci.conf` and change the following lines.

```

DATABASE_NAME=builder

DATABASE_USER=builder

DATABASE_PASSWORD=builder

ALLOWED_HOSTS=mybuilder.com

```

Now fix the previous error with `apt -f install`

### Configure Nginx

Create a simple nginx configuration that will be used also serve static files.

```

server {

    listen 80;

    server_name mybuilder.com;

    location /static/ {

        alias /usr/share/builder-ci/statics/;

    }

    location / {

        proxy_set_header Host $host;

        proxy_pass http://127.0.0.1:8000;

        proxy_http_version 1.1;

        proxy_set_header Upgrade $http_upgrade;

        proxy_set_header Connection "upgrade";

    }

}

```

If you need to setup letsencrypt certificate, install `python3-certbot-nginx` and run `certbot --nginx`.

### Create first django user

```

set -a ; . /etc/builder-ci/builder-ci.conf

cd /usr/share/builder-ci/

. ./venv/bin/activate # Dont forgot the first dot

python3 manage.py createsuperuser

```

### Now open

> https://mybuilder.com

And login with your super user.

## Frequently Asked Questions

### Is Builder CI stable for production use?

Yes. It's used in production with frameworks like Laravel, Symfony, Ionic, Flutter, NestJS, Angular, and React across platforms such as Android, Debian, Ubuntu, Red Hat, and CentOS.

## I'm using redmine, can I have build status inside?

Yes, we did a [Redmine plugin](https://github.com/iabsis/redmine-builder-ci). Once installed, create API key and configure

```

REDMINE_URL=https://<your redmine host>

REDMINE_KEY=<your redmine key>

```

## Does Builder support SSO

Yes, you can configure SSO like Keycloak by configuring OpenID in configuration.

```

OPENID_ID=sso

OPENID_NAME="<display name on login page>"

OPENID_CLIENT_ID=<your keycloak client ID>

OPENID_SECRET=<your keycloak secret>

OPENID_CONFIGURATION_URL="https://<your keycloak url>/realms/<your keycloak realm>/.well-known/openid-configuration"

```

## Contributing

We welcome contributions of all kinds — including code, documentation, bug reports, and feature suggestions.

While formal contributing guidelines are coming soon, you can:

- Fork the repository

- Create a new branch for your changes

- Open a pull request

- Share feedback via comments or discussions

---

## License

Builder CI is licensed under the [GPL-3.0 License](LICENSE).