Alby Lite

A minimal Lightning address server powered by NWC

API

Create a new user

POST /users

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

returns

{
    "lightningAddress": "91290133601@albylite.com"
}

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.

fishcakeday/lite