diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7338f49
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# Infrastructure
+
+These are the configs and infra stuff for this site (name TBD)!
+
+- `gitea`: system configuration for the gitea instance
+- `nix`: pinned nix stuff, both tools and upstreams for nixos
+- `terraform`: terraform configuration for compute/DNS resources
+
+## Local Setup
+
+- `git clone` using the instructions on the unnamed site.
+- `direnv allow` to get the versions of tools
+
+If you're working with Terraform stuff, `cd terraform && terraform init`.
+Contact Brian for access to the remote states and the with-great-power-comes-great-responsibility speech.
+
+For making changes to instances after provision, see instructions in `gitea`.