This is a nostr relay, written in Typescript.
This implementation is production-ready. See below for supported features.
The project master repository is available on GitHub.
NIPs with a relay-specific implementation are listed here.
- NIP-01: Basic protocol flow description
- NIP-02: Contact list and petnames
- NIP-04: Encrypted Direct Message
- NIP-09: Event deletion
- NIP-11: Relay information document
- NIP-12: Generic tag queries
- NIP-13: Proof of Work
- NIP-15: End of Stored Events Notice
- NIP-16: Event Treatment
- NIP-20: Command Results
- NIP-22: Event
created_atLimits - NIP-26: Delegated Event Signing
- NIP-28: Public Chat
- NIP-33: Parameterized Replaceable Events
- PostgreSQL 15.0
- Redis
- Node v18
- Typescript
- Docker v20.10
- Docker Compose v2.10
- Docker Desktop v4.2.0 or newer
- mkcert
WARNING: Docker distributions from Snap, Brew or Debian repositories are NOT SUPPORTED and will result in errors. Install Docker from their official guide ONLY.
- Set up a Nostr relay in under 5 minutes by André Neves (CTO & Co-Founder At ZEBEDEE)
Install Docker Desktop following the official guide. You may have to uninstall Docker on your machine if you installed it using a different guide.
Clone repository and enter directory:
git clone git@github.com:Cameri/nostream.git
cd nostream
Start:
./scripts/start_local
This will run in the foreground of the terminal until you stop it with Ctrl+C.
Install Docker following the official guide. You may have to uninstall Docker if you installed it using a different guide.
Clone repository and enter directory:
git clone git@github.com:Cameri/nostream.git
cd nostream
Start:
./scripts/start
or
./scripts/start_with_tor
Stop the server with:
./scripts/stop
Print the Tor hostname:
./scripts/print_tor_hostname
By default this server will run continuously until you stop it with Ctrl+C or until the system restarts.
You can install as a systemd service if you want the server to run again automatically whenever the system is restarted. For example:
$ nano /etc/systemd/system/nostream.service
# Note: replace "User=..." with your username, and
# "/home/nostr/nostream" with the directory where you cloned the repo.
[Unit]
Description=Nostr TS Relay
After=network.target
StartLimitIntervalSec=0
[Service]
Type=simple
Restart=always
RestartSec=5
User=nostr
WorkingDirectory=/home/nostr/nostream
ExecStart=/home/nostr/nostream/scripts/start
ExecStop=/home/nostr/nostream/scripts/stop
[Install]
WantedBy=multi-user.target
And then:
systemctl enable nostream
systemctl start nostream
The logs can be viewed with:
journalctl -u nostream
Set the following environment variables:
DB_HOST=localhost
DB_PORT=5432
DB_NAME=nostr_ts_relay
DB_USER=postgres
DB_PASSWORD=postgres
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_USER=default
REDIS_PASSWORD=nostr_ts_relay
Create nostr_ts_relay database:
$ psql -h $DB_HOST -p $DB_PORT -U $DB_USER -W
postgres=# create database nostr_ts_relay;
postgres=# quit
Start Redis and use redis-cli to set the default password and verify:
$ redis-cli
127.0.0.1:6379> CONFIG SET requirepass "nostr_ts_relay"
OK
127.0.0.1:6379> AUTH nostr_ts_relay
Ok
Clone repository and enter directory:
git clone git@github.com:Cameri/nostream.git
cd nostream
Install dependencies:
npm install -g knex
npm install
Run migrations (at least once and after pulling new changes):
npm run db:migrate
Create .nostr folder inside nostream project folder:
mkdir .nostr
To start in development mode:
npm run dev
Or, start in production mode:
npm run start
To clean up the build, coverage and test reports run:
npm run clean
Open a terminal and change to the project's directory:
cd /path/to/nostream
Run unit tests with:
npm run test:unit
Or, run unit tests in watch mode:
npm run test:unit:watch
To get unit test coverage run:
npm run cover:unit
To see the unit tests report open .test-reports/unit/index.html with a browser:
open .test-reports/unit/index.html
To see the unit tests coverage report open .coverage/unit/lcov-report/index.html with a browser:
open .coverage/unit/lcov-report/index.html
Open a terminal and change to the project's directory:
cd /path/to/nostream
Run integration tests with:
npm run docker:test:integration
And to get integration test coverage run:
npm run docker:cover:integration
Open a terminal and change to the project's directory:
cd /path/to/nostream
Set the following environment variables:
DB_HOST=localhost
DB_PORT=5432
DB_NAME=nostr_ts_relay_test
DB_USER=postgres
DB_PASSWORD=postgres
DB_MIN_POOL_SIZE=1
DB_MAX_POOL_SIZE=2
Then run the integration tests:
npm run test:integration
To see the integration tests report open .test-reports/integration/report.html with a browser:
open .test-reports/integration/report.html
To get the integration test coverage run:
npm run cover:integration
To see the integration test coverage report open .coverage/integration/lcov-report/index.html with a browser.
open .coverage/integration/lcov-report/index.html
You can change the default folder by setting the NOSTR_CONFIG_DIR environment variable to a different path.
Run nostream using one of the quick-start guides at least once and nostream/.nostr/settings.json will be created.
Any changes made to the settings file will be read on the next start.
A sample settings file is included at the project root under the name settings.sample.json. Feel free to copy it to nostream/.nostr/settings.json
if you would like to have a settings file before running the relay first.
See CONFIGURATION.md for a detailed explanation of each environment variable and setting.
For development discussions, please use the Nostr Typescript Relay Dev Group.
For discussions about the protocol, please feel free to use the Nostr Telegram Group.
I'm Cameri on most social networks. You can find me on Nostr by npub1qqqqqqyz0la2jjl752yv8h7wgs3v098mh9nztd4nr6gynaef6uqqt0n47m.
- Anton Livaja
- Juan Angel
- Kevin Smith
- Saransh Sharma
- swissrouting
This project is MIT licensed.