Back to selected work

DevOps & enterprise infrastructure

Frappe Docker

A repeatable foundation for enterprise applications.

Personal projectDevelopment infrastructureMIT license
Frappe Docker
instance.json Go / shell entrypoint Frappe + MariaDB + Redis
Architecture overview

The overview

An unofficial Docker Compose environment for Frappe and ERPNext development, with configurable applications, site provisioning, persistent storage, and Go or shell entrypoints.

The problem

Keep a configurable development environment repeatable while allowing direct access to application code, service configuration, and site-specific app requirements.

How it fits together

Docker Compose coordinates Frappe, MariaDB, and Redis. An entrypoint reads instance.json to create missing sites, align installed applications, and migrate them. Bind-mounted workspaces preserve direct local editing.

  1. instance.json
  2. Go / shell entrypoint
  3. Frappe + MariaDB + Redis

Implementation highlights

  • Sites and required applications are aligned from an explicit instance configuration.

  • Go and shell implementations support different automation needs.

  • Persistent bind mounts retain workspace changes across container lifecycles.

Engineering considerations

This is an independent development environment, not the official Frappe Docker project. The Go implementation applies instance.json but does not update that file itself. Destructive site removal is an explicit configuration option.

Go deeper

Next projectJVMS