aerie#
aerie is a Cloudflare-native community implementation of the Tangled knot server, building on Tangled Labs Oy's MIT-licensed upstream. Fork blessed by Anirudh Oppiliappan (Tangled co-founder & CEO) on 2026-04-28. aerie publishes the same sh.tangled.* lexicons unchanged, so aerie-hosted repositories render natively on tangled.org's appview.
deployment#
L3 ships the Cloudflare Containers package shape under deploy/cloudflare/: a Dockerfile, Go entrypoint, Worker shim, and wrangler.toml.
Deployment is operator-driven after v1 ships. See deploy/cloudflare/README.md for install-path decisions, required secrets, and operational notes.
what this is#
aerie is sol pbc's Cloudflare-native implementation of the Tangled knot. v1 keeps inherited Tangled behavior intact while adding three things this repository ships end-to-end: a pure-Go (CGO-free) build via modernc.org/sqlite, an opt-in authenticated HTTPS git-receive-pack path behind KNOT_SERVER_ENABLE_HTTPS_PUSH, and the Cloudflare Containers deployment shape under deploy/cloudflare/. The fork-base SHA, patch-category taxonomy, and upstream PR cadence are tracked in UPSTREAM.md; the community posture and lexicon-namespace commitment live in COMMUNITY.md.
This repository is software, not an operated public service at v1.
build#
Use:
make installmake testmake lintmake build
make build produces bin/knot as a statically linked binary using the pure-Go modernc.org/sqlite driver by default (BUILD_TAGS=modernc, CGO_ENABLED=0). For parity testing against upstream Tangled's default CGO/mattn behavior, use BUILD_TAGS= CGO_ENABLED=1 make build.
make ci runs install lint test build. v1 assumes Linux; Apple toolchains are out of scope.
run#
The static knot binary's help entry point is:
bin/knot server --help
The server subcommand is server.
relationship to upstream tangled#
aerie keeps an upstream-friendly fork of upstream Tangled at tangled.org/tangled.org/core. UPSTREAM.md is the ledger for the fork-base SHA, patch categories, and the upstream PR cadence for changes that can be offered back after they are green in aerie.
status#
v1 ships software, not an operated public aerie instance. No public aerie instance for non-founder users ships with v1.
license#
MIT; see license.
For the fork rationale, appview-parity commitment, and lexicon-namespace rule, see COMMUNITY.md.