Welcome to the Qlico Documentation

Qlico is an open-source project designed to simplify running your web projects inside Docker. At its core, it is a set of configuration files intended to streamline the development process for teams by providing a hassle-free Docker stack.

Why Choose Qlico?

• Easy Configuration: Select only the parts/services you need.
• Customizable: Use and extend your own configuration files effortlessly.
• User-Friendly: Maintains the default docker compose experience with enhanced testing.
• Team Collaboration: Standardize configurations across projects ( e.g., postgres16 for PostgreSQL 16, mysql8 for MySQL 8).

Prerequisites

• Docker >= 26.0
• dnsmasq (optional, but recommended)
• Basic knowledge of Docker and Docker Compose

For beginners:

• Docker Get Started (Skip "Share the application part" as Docker Hub account is not needed)
• Docker for Beginners (Skip all AWS parts, because it's using Elastic Beanstalk)

Best Docker Experience

• Windows: Docker Desktop with WSL2.
• macOS: OrbStack
• Linux:
  • Arch Linux, see this excellent wiki page
  • Ubuntu
  • Debian
  • CentOS
  • Fedora

Getting Started

To start using Qlico, please refer to the Quick Start Guide.

History

Qlico began in 2017 as a side project to manage multiple Dockerfiles for various PHP versions. Initially, all projects were mounted inside a single webserver, leading to performance issues on macOS and difficulties in managing PHP versions per project. To overcome these challenges, Tom created a new, more efficient Docker stack, and Qlico was born.

The Name Qlico

The name Qlico is derived from "Kliko," a term for plastic trash cans in the Netherlands, symbolizing the use of "containers" in Docker/Kubernetes.

"There are only two hard things in Computer Science: cache invalidation and naming things." -- Phil Karlton

Picture of Kliko's

Qlico in Production

Qlico is suitable for both development and production environments. Use the prod stage of the Dockerfile for production deployment. Many companies successfully run Qlico in production within Kubernetes clusters. For assistance, contact Tom or start a GitHub Discussion.

Contributing

Qlico is open-source, and contributions are welcome! Fork the project, make a Pull Request, or create an Issue for any problems, including typos and grammar improvements.

License

Qlico is licensed under the MIT License with one exception: The name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.

Stargazers

If you enjoy using Qlico, please star the Qlico GitHub project.