ligo.at#

Decentralized and customizable links page on top of AT Protocol.

dependencies#

Install uv and run uv sync.

generate secrets#

Use the etc/generate_secrets.py script or run make .env.

synchronization#

ligo.at reads directly from the users' PDS. A small cache is used to serve profile pages quicker. The cache is updated on every profile write, and when requesting a profile with the ?reload query parameter (any value, even empty). ligo.at also reads from the Jetstream, so updates made to a profile outside of ligo.at should also be available instantly.

run#

Either start a debug server with make debug or a production one with make run. Production needs the PORT environment variable.

The Jetstream ingestor can be started with make ingestor.

Some example configuration files are provided in the etc folder. They assume the code will live at /var/www/ligoat. Keep this in mind if you want to place it somewhere else.

• A Caddyfile that configures a caddy reverse proxy.
• Two systemd service files. They can be used to run both the server and the jetstream ingestor.