ssb-server is an open source peer-to-peer log store used as a database, identity provider, and messaging system. It has:
- Global replication
- End-to-end encryption
ssb-server behaves just like a Kappa Architecture DB. In the background, it syncs with known peers. Peers do not have to be trusted, and can share logs and files on behalf of other peers, as each log is an unforgeable append-only message feed. This means ssb-servers comprise a global gossip-protocol mesh without any host dependencies.
If you are looking to use ssb-server to run a pub, consider using ssb-minimal-pub-server instead.
Join us in #scuttlebutt on freenode.
a known-working shrinkwrapped version will be installed.
npm install -g ssb-server
There are already several applications built on ssb-server, one of the best ways to learn about secure-scuttlebutt is to poke around in these applications.
- patchwork is a discussion platform that we use to anything and everything concerning ssb and decentralization.
- patchbay is another take on patchwork - it's compatible, less polished, but more modular. The main goal of patchbay is to be very easy to add features to.
- git-ssb is git (& github!) on top of secure-scuttlebutt. Although we still keep our repos on github, primary development is via git-ssb.
it is recommended to get started with patchwork, and then look into git-ssb and patchbay.
Example Usage (bash)
# Start the server with extra log detail# Leave this running in its own terminal/windowssb-server start --logging.level=info# publish a messagessb-server publish --type post --text "My First Post!"# stream all messages in all feeds, ordered by publish timessb-server feed# stream all messages in all feeds, ordered by receive timessb-server log# stream all messages by one feed, ordered by sequence numberssb-server hist --id $FEED_ID
Example Usage (js)
var Server =var config =var fs =var path =// add pluginsServervar server =// save an updated list of methods this server has made public// in a location that ssb-client will know to checkvar manifest = serverfs
see: github.com/ssbc/ssb-config for custom configuration.
var pull =var Client =// create a ssb-server client using default settings// (server at localhost:8080, using key found at ~/.ssb/secret, and manifest we wrote to `~/.ssb/manifest.json` above)
ssb-server's message-based data structure makes it ideal for mail and forum applications (see Patchwork). However, it is sufficiently general to be used to build:
- Office tools (calendars, document-sharing, tasklists)
- Package managers
Because ssb-server doesn't depend on hosts, its users can synchronize over WiFi or any other connective medium, making it great for Sneakernets.
ssb-server is eventually-consistent with peers, and requires exterior coordination to create strictly-ordered transactions. Therefore, by itself, it would probably make a poor choice for implementing a crypto-currency. (We get asked that a lot.)
- Install - Setup instructions
- Tutorial - Primer on developing with ssb-server
- API / CLI Reference (out of date, but still the best reference)
- ssb-config - a module which helps build config to start ssb-server with
- ssb-client - make a remote connection to the server
- Modules docs - see an overview of all the modules
- Secure Scuttlebutt, ssb-server's global database protocol
- Content Hash Linking
- Secret Handshake, ssb-server's transport-layer security protocol
- Private Box, ssb-server's end-to-end security protocol
- Frequently Asked Questions
- Design Challenge: Avoid Centralization and Singletons
- Design Challenge: Sybil Attacks
- Using Trust in Open Networks