Alexandria
Getting Started

Prerequisites

Tooling and default network ports for building and running Alexandria.

Prerequisites


Tooling

ToolVersionNeeded for
Goas pinned in go.modBuilding the binaries and running every test suite. SQLite is embedded (modernc.org/sqlite, no cgo).
GNU Make or Taskany recentThe Makefile and Taskfile.yaml expose the same targets.
Node.js and pnpm20+ / 10+Optional. The console (gui/) and this documentation site (docs/).
Python 33.10+Optional. The Jupyter tutorials in tutorial/.

make build test conformance e2e trace needs only Go. No containers, databases or external services are required: the demo and the end-to-end test start the real binaries on free local ports.


Default Ports

These are the values of the sample configurations in config/ and deploy/.

PortProcessListenerPurpose
8443alexandria-serverlisten (HTTPS)/v1 management API, /pub publication and, when embedded, the console at /ui/.
9400fake-idp—OIDC discovery, JWKS, /authorize, /token.
8282fake-connector—Upstream DSP connector of the client.
9080alexandria-clientdsp-ingressReverse proxy for inbound DSP messages.
9081alexandria-clientdsp-egressForward proxy for outbound DSP messages.
9090alexandria-clientadminAdmin API, metrics and, when embedded, the console at /ui/.
5273Vite—Console development server (make gui-dev).
3000Next.js—Documentation development server (make docs-dev).

Port 9090 is commonly taken by other tools. If the client admin listener fails to bind, change listeners.admin.bind in the client configuration.

The hub generates its Ed25519 signing key and a self-signed laboratory TLS certificate on first start when the configured files are absent. The client must be told to trust that certificate (connection.tls.ca in the section layout, or the -hub-ca flag).

On this page