Skip to content

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.

License

Notifications You must be signed in to change notification settings

FabienD/docker-stack

Repository files navigation

Github Actions GitHub release Codecov dependency status GitHub 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


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

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.
  • Add commands to register/unregister projects using docker-compose files.
  • Make default arguments optional and project-specific.
  • Improve merging of default and command-line arguments.

v1

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

v2

  • Refactor the CLI tool for better architecture and code quality.

Contributing

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


License

This project is licensed under the MIT License.

About

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.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages