Alby Lite

A minimal Lightning address server powered by NWC

API

Create a new user

POST /users

{
    "connectionSecret": "nostr+walletconnect://..."
}

returns

{
    "lightningAddress": "[email protected]"
}

Development

• Install Deno
• Copy .env.example to .env
• Setup DB: deno task db:migrate
• Run in dev mode: deno task dev

Creating a new migration

• Edit the schema (./src/db/schema.ts)
• Create the migration files: deno task db:generate
• The migration will automatically happen when the app starts.

Running Tests

deno task test

Deployment

Environment variables must be setup, including a postgres database connection. Please see .env.example.

Run with Deno

deno task start

Docker (from Alby's Container Registry)

docker run -p 8080:8080 --pull always ghcr.io/getalby/lite:latest

Docker (from source)

docker run -p 8080:8080 $(docker build -q .)

Deploy on Fly

Make sure to update the app name and BASE_URL in fly.toml, then run:

• fly launch

When launching, make sure to include a postgres database when setting up the app, then update your app environment variables with fly secrets set.