# How the Archon Port Allocation System for Worktree Servers Enables Deterministic Multi-Instance Development

> Learn how Archon deterministically allocates TCP ports for worktree servers using MD5 hashing. Discover unique ports in the 3190-4089 range for reliable multi-instance development.

- Repository: [Cole Medin/Archon](https://github.com/coleam00/Archon)
- Tags: internals
- Published: 2026-04-10

---

**Archon allocates TCP ports for worktree-based servers by hashing the absolute worktree path with MD5 to generate a deterministic offset between 100-999, which is added to base port 3090 to produce a unique port in the 3190-4089 range.**

The Archon framework (coleam00/Archon) implements a sophisticated runtime port allocation mechanism that eliminates manual port configuration when running multiple server instances from different git worktrees. This system automatically calculates a unique, deterministic port for each worktree directory, enabling parallel development