solid-pod-rs-server

Binary distribution of solid-pod-rs — a drop-in JSS replacement that runs as a single static-ish Rust binary.

Install

Once published to crates.io (target: v0.4.0):

cargo install solid-pod-rs-server
solid-pod-rs-server --config config.json

Until then, build from source:

cargo build --release -p solid-pod-rs-server
./target/release/solid-pod-rs-server --help

This crate is a thin binary shell over solid-pod-rs. Per ADR-056 §D3 (F7 library-server split):

solid-pod-rs — pure library. No #[tokio::main], no actix-web::HttpServer. Framework-agnostic.
solid-pod-rs-server (this crate) — owns the actix-web HTTP server, the tokio runtime, clap CLI, the F6 layered config loader, and signal handling. Depends on the library and wires its PodService-style primitives into concrete HTTP routes.

Configuration is loaded by [solid_pod_rs::config::ConfigLoader] (F6, PRD §F6). Precedence (later overrides earlier):

Defaults  <  File  <  EnvVars  <  CLI flags

See crates/solid-pod-rs/src/config/sources.rs for the full JSS_* environment variable table.

This binary enables the following solid-pod-rs features by default:

Feature	Purpose
`fs-backend`	Filesystem storage (JSS default)
`memory-backend`	In-memory storage (test / dev)
`config-loader`	F6 layered config loader
`legacy-notifications`	F3 `solid-0.1` WS notifications adapter

Other feature flags (oidc, dpop-replay-cache, nip98-schnorr, s3-backend) can be opted into by the operator via a custom build.

AGPL-3.0-only. See LICENSE. Operating this binary as a network service triggers AGPL §13 source-disclosure obligations.

solid-pod-rs-activitypub — ActivityPub federation (4,453 LOC)
solid-pod-rs-git — Git HTTP backend (1,685 LOC)
solid-pod-rs-idp — Solid-OIDC identity provider (6,160 LOC)
solid-pod-rs-nostr — did:nostr + embedded Nostr relay (2,177 LOC)
solid-pod-rs-didkey — did:key (Ed25519/P-256/secp256k1) + JWT (1,167 LOC)