docker-stack

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 24 Open GitHub ↗

A curated collection of ready-to-use Docker Compose files for local web development, plus a powerful CLI (dctl) to manage and orchestrate your registered stacks from anywhere in your terminal.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Github Actions](https://github.com/FabienD/docker-stack/actions/workflows/dctl_cli.yml/badge.svg)](https://github.com/FabienD/docker-stack/actions)
[![GitHub release](https://img.shields.io/github/release/FabienD/docker-stack.svg)](https://github.com/FabienD/docker-stack/releases)
[![Codecov](https://codecov.io/github/FabienD/docker-stack/branch/main/graph/badge.svg?token=IH5NLYP8K4)](https://codecov.io/github/FabienD/docker-stack)
[![dependency status](https://deps.rs/repo/github/FabienD/docker-stack/status.svg?path=cli)](https://deps.rs/repo/github/FabienD/docker-stack?path=cli)
[![GitHub license](https://img.shields.io/github/license/FabienD/docker-stack.svg)](https://github.com/FabienD/docker-stack/blob/main/LICENSE)

# Docker Stack

**Docker Stack** is a developer-oriented project that provides:

- **A powerful CLI tool (`dctl`)**: A drop-in replacement for Docker Compose, with extra features and improved usability.
- **A curated collection of Docker Compose files**: Ready-to-use configurations for a complete local development stack.

You can use the CLI and the compose files independently or together, depending on your needs.

---

## Overview

- **[CLI Tool Documentation](doc/dctl.md):** Manage your local Docker Compose projects more easily with `dctl`.
- **[Compose Files Collection](doc/collection.md):** Quickly set up a local web development stack with pre-configured services.
- **[Changelog](CHANGELOG.md):** See what's new.

---

## Why use `dctl` instead of `docker compose`?

- No need to be in your project folder.
- Uses the same commands and arguments as Docker Compose—no new learning curve.
- Manage multiple projects from anywhere in your terminal.
- Easily override default compose files and set default arguments for all commands.

[![asciicast](https://asciinema.org/a/7VwsLtJmxzZ2HCkbim3kUQ21e.svg)](https://asciinema.org/a/7VwsLtJmxzZ2HCkbim3kUQ21e)

With `dctl`, you can start, stop, restart, build, and manage multiple Docker Compose projects from anywhere, without the need for custom shell aliases. The CLI also allows you to define default arguments and override compose files per project.

---

## Roadmap

- [ ] Add more documentation and examples for local development.
- [ ] Make default arguments optional and project-specific.
- [ ] Improve merging of default and command-line arguments.

### v1

- [x] Publish the CLI tool for multiple platforms (Windows, Mac, Linux) and architectures (x86, arm, arm64).
- [x] Improve the `check-config` command.
- [x] Add CLI examples and screenshots.

### v2

- [x] Refactor the CLI tool for better architecture and code quality.
- [x] Declarative argument system with type validation.
- [x] Full `exec`/`run` command support with command arguments.
- [x] 65% code reduction through declarative definitions.
- [x] All 24 commands verified against Docker Compose documentation.
- [x] `register`/`unregister` commands to manage projects from CLI.
- [x] YAML validation in `check-config` with `--validate` flag.
- [x] Parallel execution for `infos` command.

---

## Contributing

Contributions are welcome! Feel free to open an issue or a pull request.

---

## License

This project is licensed under the [MIT License](LICENSE).

docker-stack

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README