Skip to content

What is DockIY?

DockIY is a minimal, open-source Docker setup for deploying multiple web applications to one VPS. It adds a small CLI while keeping the infrastructure and application code under your control.

DockIY uses normal, editable files and commands. It is not a hosted platform or hidden control plane. Applications keep their own Dockerfiles, Compose files, Traefik labels, secrets, manifest, and lifecycle hooks.

The base stack

A DockIY VPS provides a small set of shared services:

  • Traefik routes domains to application containers and provisions TLS certificates.
  • Umami provides privacy-friendly web analytics.
  • Dozzle displays Docker container logs.
  • Beszel monitors the server and sends notifications.
  • Docker Registry stores application images on the VPS.

The registry listens only on the VPS loopback interface. The CLI accesses it through an SSH tunnel, so it does not need a public domain or registry credentials.

Philosophy

DockIY aims to be:

  • simple enough to understand and change;
  • independent of hosted CI/CD and deployment services;
  • portable to any VPS that can run Docker;
  • close to infrastructure as code;
  • explicit about the Docker, SSH, and Compose commands it runs.

The base repository owns shared server infrastructure. Each application repository owns everything specific to that application.

Current workflow

  1. Run dockiy setup to create a global server profile.
  2. Run dockiy server init to install the base stack.
  3. Create an application with dockiy app init, or use an existing repository with a valid dockiy.yml.
  4. Run dockiy app deploy from the application repository.

The CLI coordinates Git, Docker, SSH, rsync, SOPS, and app-owned hooks. It does not hide or replace those tools.

Next steps

Released under the MIT License.