gitwtfhub

wtf is homescale?

homescale-dev/homescale — explained in plain English

Analysis updated 2026-05-18

55ShellAudience · ops devopsComplexity · 4/5Setup · hard

TL;DR

An experimental local setup that mimics PlanetScale's database branching using Kubernetes and Ceph storage on your own machine.

Mindmap

mindmap
  root((homescale))
    What it does
      Local database branching
      Point in time snapshots
      Copy on write clones
    Tech stack
      Kubernetes K3s
      Rook and Ceph
      Lima VM
      Shell scripts
    Use cases
      Test database branching locally
      Learn Ceph storage concepts
      Prototype PlanetScale-like workflows
    Audience
      Developers
      Infrastructure engineers
    Setup
      Requires mise tool
      Task-based commands
      No redundancy or backup

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Experiment locally with database branching similar to PlanetScale.

REASON 2

Learn how Ceph snapshots and copy on write cloning work in practice.

REASON 3

Prototype a Kubernetes and Ceph based storage workflow before deploying it.

REASON 4

Test point in time restore and volume isolation on a single machine.

What's in the stack?

ShellKubernetesK3sRookCephLima

How it stacks up

homescale-dev/homescalenelsonwerd/idea-to-ship-skillsramset/pihole-ha-cluster
Stars555456
LanguageShellShellShell
Setup difficultyhardmoderatemoderate
Complexity4/53/53/5
Audienceops devopsvibe coderops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Needs at least 20 GiB free storage, a Lima VM, and installs a full Kubernetes plus Ceph stack.

The README does not state a license.

Wtf does this do

Homescale is an experiment in building something like PlanetScale, the commercial database branching service, but running entirely on your own computer. It lets you create writable database instances and point in time branches from immutable snapshots, without having to copy the entire database each time you want a new branch. Under the hood it combines a few well known open source infrastructure tools. Kubernetes acts as the control plane that manages everything. Rook operates Ceph, a distributed storage system, and Ceph RBD provides the block storage, the snapshots, and the copy on write clones that make cheap branching possible. All of this runs inside a single node Kubernetes cluster (via K3s) on a Lima virtual machine, so nothing needs to be installed directly on your host machine. To use it you install a tool called mise, then run a small set of task commands: one to bring the whole environment up (creating the VM, installing Kubernetes, snapshotting, Rook, and Ceph until the storage system reports healthy), one to test that snapshot restore and copy on write isolation actually work, one to gracefully shut the VM down while keeping its disks, and one to fully clean up and delete everything. The README is explicit that this setup has no redundancy or backup: there is only one monitor, one manager, one storage node, and one copy of every object. It is described plainly as an experiment, not a production ready system, and needs at least 20 GiB of free host storage to run.

Yoink these prompts

Prompt 1
Walk me through setting up Homescale for the first time using mise and the task commands.
Prompt 2
Explain how Homescale's copy on write cloning avoids copying the whole database.
Prompt 3
Help me troubleshoot a Ceph health check failure after running Homescale's up command.
Prompt 4
What are the risks of Homescale having no redundancy or backup, based on its README?

Frequently asked questions

wtf is homescale?

An experimental local setup that mimics PlanetScale's database branching using Kubernetes and Ceph storage on your own machine.

What language is homescale written in?

Mainly Shell. The stack also includes Shell, Kubernetes, K3s.

What license does homescale use?

The README does not state a license.

How hard is homescale to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is homescale for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.