> ## Documentation Index
> Fetch the complete documentation index at: https://docs.the40thieves.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# own-the-house

> A guided runbook for standing up your own single-host AI substrate in a weekend: one small box, real tools, no data center.

You rent the model. You own the house. This guide takes you from an empty cloud instance to a locked-down box running a model gateway, a coding agent, a few tools, and a memory that stays yours when the models change.

The guide is the reading copy of the [own-the-house repository](https://github.com/The-40-Thieves/own-the-house). The scripts, config files and templates that the steps name (such as `scripts/lock-edge.sh` and `gateway/litellm.config.yaml`) live in that repository, so clone it before you start.

## What you end up with

A single Ubuntu 24.04 ARM box on which:

* Nothing faces the open internet except one SSH door. Everything else lives on a private [Tailscale](https://tailscale.com) mesh.
* One gateway ([LiteLLM](https://litellm.ai)) fronts every model provider, so switching models is one line of config.
* An agent reaches the models through that gateway and calls a small set of tools over [MCP](https://modelcontextprotocol.io).
* A notes vault that the agent reads and writes gives the system a memory, even though the model has none.

The box is free on Oracle Always Free ARM, or a few euros a month on Hetzner. The only real recurring cost is your model subscription.

## Run it with an AI agent

The build is designed to be run with an AI assistant as your guide, one verified step at a time. Hand the repository to your assistant and start with [AGENTS.md](https://github.com/The-40-Thieves/own-the-house/blob/main/AGENTS.md).

## The steps

| Step | Page | Files in the repository |
| - | - | - |
| 0 | [Provision the box](https://docs.the40thieves.dev/own-the-house/00-provision-oci.md) | None |
| 1 | [Lock the edge](https://docs.the40thieves.dev/own-the-house/01-lock-the-edge.md) | `scripts/lock-edge.sh` |
| 2 | [Put up the gateway](https://docs.the40thieves.dev/own-the-house/02-gateway.md) | `gateway/` |
| 3 | [Add an agent and tools](https://docs.the40thieves.dev/own-the-house/03-agent-and-tools.md) | `agent/` |
| 4 | [Give it memory](https://docs.the40thieves.dev/own-the-house/04-memory.md) | `memory/` |

Check each step with `scripts/preflight.sh` before you move to the next one.

## Read before you build

* [PRINCIPLES.md](https://github.com/The-40-Thieves/own-the-house/blob/main/PRINCIPLES.md) lists the seven principles that shape the build.
* [WHEN-NOT-TO.md](https://github.com/The-40-Thieves/own-the-house/blob/main/WHEN-NOT-TO.md) says when a single box is the wrong answer.
* [SECURITY.md](https://github.com/The-40-Thieves/own-the-house/blob/main/SECURITY.md) describes the zero-ingress threat model.

The build stops at the foundation on purpose. [Grow into it](https://docs.the40thieves.dev/own-the-house/grow-into.md) covers what to add later, and in what order.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.