hulxv/Nostr Relay
Downloads and starts a pre-built nostr-rs-relay
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Mar 7, 2026
- License
- MIT
Pinned Snippet
uses: hulxv/nostr-relay-action@f9b2992e6dac9fa9fe7509633f677b1313d8c7c0 # v1.0.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| port | Port to run the relay on | no | 8000 |
| address | Address to bind the relay on | no | 0.0.0.0 |
| version | Release tag from nostr-relay-action repo (e.g. master or 0.9.0) | yes | — |
| start | Whether to start the relay after downloading | no | true |
| relay_url | Public-facing URL of the relay | no | "" |
| name | Relay name | no | nostr-rs-relay (CI) |
| description | Relay description | no | "" |
| pubkey | Relay operator pubkey (hex) | no | "" |
| contact | Relay operator contact | no | "" |
| max_event_bytes | Maximum size of an EVENT message in bytes | no | 262144 |
| max_ws_message_bytes | Maximum WebSocket message size in bytes | no | 262144 |
| max_ws_frame_bytes | Maximum WebSocket frame size in bytes | no | 262144 |
| messages_per_sec | Max event writes per second (leave empty for unlimited) | no | "" |
| subscriptions_per_min | Max subscriptions per minute (leave empty for unlimited) | no | "" |
| event_kind_blacklist | Comma-separated list of event kinds to blacklist | no | "" |
| event_kind_allowlist | Comma-separated list of event kinds to allowlist | no | "" |
| limit_scrapers | Whether to limit scrapers | no | false |
| pubkey_whitelist | Comma-separated list of pubkeys allowed to publish (leave empty to allow all) | no | "" |
| nip42_auth | Enable NIP-42 authentication | no | false |
| nip42_dms | Send DMs only to authenticated recipients (requires nip42_auth) | no | false |
| db_engine | Database engine (sqlite or rocksdb) | no | sqlite |
| db_min_conn | Minimum database connections | no | 4 |
| db_max_conn | Maximum database connections | no | 8 |
| db_in_memory | Use in-memory database (data lost on stop) | no | true |
| reject_future_seconds | Reject events with a timestamp more than X seconds in the future (leave empty to disable) | no | "" |
Outputs
no outputs