buildninja-docker-compose-examples

KO | EN

gitlite — search

#python #react #ai #typescript #android #machine-learning #deep-learning #linux #docker #java #kubernetes #ios #mcp #open-source

buildninja-docker-compose-examples

(★ 20)

No description available.

buildninja-docker-compose-examples Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# BuildNinja Docker Compose Examples

[![Docker Pulls](https://img.shields.io/docker/pulls/grapehub/buildninja-server)](https://hub.docker.com/r/grapehub/buildninja-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Production-ready Docker Compose configurations for BuildNinja - a simple, self-hosted CI/CD platform and Jenkins alternative. Perfect for teams who want Docker CI/CD and DevOps automation without the enterprise complexity.

## Quick Start

```bash
# 1. Clone this repository
git clone https://github.com/BuildNinja-CICD/buildninja-docker-compose-examples.git
cd buildninja-docker-compose-examples/basic

# 2. Copy and configure environment variables
cp .env.example .env

# 3. Start BuildNinja
docker compose up -d
```

Access BuildNinja at `http://localhost:8800`

> **Default credentials:** `root` / `root@123`
> **Warning:** Change these immediately after first login!

## Your First Build

After logging in (default: `root` / `root@123`), create a simple build:

1. **Create Project:** Go to Projects → Add New Project → Enter name → Create

2. **Create Build Configuration:** Select your project → New Build Configuration → Enter name → Create

3. **Add Execution Step:**
   - Go to Execution Steps → Add Execution Step
   - Select Runner: `Command Line`
   - Commands: `echo Hello BuildNinja`
   - Click OK → Save

4. **Authorize Agent:** Go to Agents → Find your agent → Actions tab → Authorize

5. **Run Build:** Go back to your build → Click "Run Build"

You should see a successful build in the History tab!

## Why BuildNinja?

- **Simple CI/CD setup** - Get running in minutes, not days
- **Self-hosted CI/CD** - Keep your code and builds on your infrastructure
- **Docker CI/CD** - Native Docker support with easy container orchestration
- **Jenkins alternative** - Enterprise features without enterprise complexity
- **DevOps automation** - Streamline your build, test, and deployment workflows

## Configurations

| Configuration | Use Case | Features |
|--------------|----------|----------|
| [basic/](./basic/) | Development, testing | Single server + single agent, minimal setup |
| [with-persistent-storage/](./with-persistent-storage/) | Production | Named volumes for data persistence across restarts |

## Prerequisites

- Docker and Docker Compose installed
- Ports 8800 (server), 9500 (agent), and 27017 (MongoDB) available

## Environment Variables

### Server Variables

| Variable | Description | Required | Default |
|----------|-------------|----------|---------|
| `BN_VERSION` | BuildNinja image version | No | `1.0.0` |
| `BN_SERVER_PORT` | Port the server listens on | No | `8800` |
| `BN_SERVER_MONGOURI` | MongoDB connection URI | Yes | - |
| `BN_SERVER_MONGODB` | MongoDB database name | No | `bn_server` |
| `BN_SERVER_JWT_SIGN_KEY` | Secret key for JWT tokens | Yes (prod) | - |
| `BN_SERVER_DATA_DIR` | Directory for internal data | No | `/bnserver/data` |
| `BN_SERVER_PUBLIC_URL` | Base URL for server-agent communication | Yes (prod) | - |

### Agent Variables

| Variable | Description | Required | Default |
|----------|-------------|----------|---------|
| `BN_AGENT_NAME` | Unique agent identifier | Yes | - |
| `BN_AGENT_PORT` | Port agent listens on | No | `9500` |
| `BN_AGENT_SERVER_URL` | BuildNinja server URL | Yes | - |
| `BN_AGENT_SELFURL` | Agent's publicly accessible URL | Yes | - |
| `BN_AGENT_DATA_DIR` | Local runtime data path | No | `/bnagent/data` |

## Architecture

```
┌─────────────────┐     ┌─────────────────┐
│   BuildNinja    │────▶│     MongoDB     │
│     Server      │     │                 │
│   (port 8800)   │     └─────────────────┘
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   BuildNinja    │
│     Agent(s)    │
│ (port 9500+)    │
└─────────────────┘
```

## Docker Images

- **Server:** [grapehub/buildninja-server](https://hub.docker.com/r/grapehub/buildninja-server)
- **Agent:** [grapehub/buildninja-agent](https://hub.docker.com/r/grapehub/buildninja-agent)

## Documentation

For full documentation, visit [buildninja.grapehub.io/docs](https://buildninja.grapehub.io/docs)

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Support

- Website: [buildninja.grapehub.io](https://buildninja.grapehub.io)
- Documentation: [buildninja.grapehub.io/docs](https://buildninja.grapehub.io/docs)
- Issues: [GitHub Issues](https://github.com/BuildNinja-CICD/buildninja-docker-compose-examples/issues)
- Contact: hello@grapehub.io

buildninja-docker-compose-examples

buildninja-docker-compose-examples Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

buildninja-docker-compose-examples

buildninja-docker-compose-examples Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README