https://github.com/itzcozi/devbox

https://github.com/itzcozi/devbox

Last synced: 10 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/itzcozi/devbox
• Owner: itzCozi
• Created: 2025-09-16T21:43:21.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-09-16T22:40:24.000Z (10 months ago)
• Last Synced: 2025-09-17T00:03:50.632Z (10 months ago)
• Language: Go
• Size: 43 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# devbox

**Isolated development environments for anything**

[![CI](https://github.com/itzcozi/devbox/workflows/CI/badge.svg)](https://github.com/itzcozi/devbox/actions)

[![Go Report Card](https://goreportcard.com/badge/github.com/itzcozi/devbox)](https://goreportcard.com/report/github.com/itzcozi/devbox)

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

devbox creates isolated development environments, contained in a project's Docker box (container). Each project operates in its own disposable environment, while your code remains neatly organized in a simple, flat folder on the host machine.

## Features

- 🚀 **Instant Setup** - Create isolated development environments in seconds

- 🐳 **Docker-based** - Leverage the power of boxes (containers) for consistent environments

- 📁 **Clean Organization** - Keep your code organized in simple, flat folders

- 🔧 **Configurable** - Define your environment with simple JSON configuration

- 🗑️ **Disposable** - Easily destroy and recreate environments as needed

- 🛡️ **Isolated** - Each project runs in its own box, preventing conflicts

- 🔄 **Docker-in-Docker** - Use Docker within your devbox environments by default

- 🧪 **Well Tested** - Comprehensive test suite with cross-platform support

## Installation

```bash

# Using the install script

curl -fsSL https://devbox.ar0.eu/install.sh | bash

# Or manually: https://devbox.ar0.eu/docs/install/#manual-build-from-source

```

## Quick Start

1. **Initialize a new project**

   ```bash

   devbox init my-project

   ```

2. **Enter the development environment**

   ```bash

   devbox shell my-project

   ```

3. **Run commands in the environment**

   ```bash

   devbox run my-project "python --version"

   ```

4. **List your environments**

   ```bash

   devbox list

   ```

5. **Clean up when done**

   ```bash

   devbox destroy my-project

   ```

### Shared configs

Commit a `devbox.json` to your repo so teammates can just:

```bash

devbox up

```

Optional: mount your local dotfiles into the box

```bash

devbox up --dotfiles ~/.dotfiles

```

## Documentation

For detailed documentation, guides, and examples, visit:

**📖 [devbox.ar0.eu](https://devbox.ar0.eu)**

## License

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

**Created by BadDeveloper with 💚**