Skip to content

pelag0s/easy-ssb-pub

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Easy Secure Scuttlebutt Pub

easy-ssb-pub is an easy-to-host server that runs an SSB "Pub".

screenshot

Secure Scuttlebutt (SSB) is an impressive peer-to-peer network that can be used for metadata, identity, and particularly, messaging. SSB is an ideal protocol for a social network. There is already a social network on SSB, called Patchwork.

However, to join the wider SSB network, you must get a dedicated invitation from a "Pub" server. Also, hosting a Pub server is not the easiest task. In order to improve adoption of SSB, this project makes it easy to deploy an SSB Pub. Once the Pub is running, it has a light frontend page where anyone can get freely request a fresh invitation.

Visit one of these

If you want to visit an Easy SSB Pub, here are a few known links (potentially ephemeral or broken):

How to deploy

You will need a server that supports exposing ports other than just 80. This means Heroku or Zeit Now will not work.

Deploy using Docker

Recommended servers-on-demand services: Digital Ocean Docker Droplet, Amazon LightSail, Vultr, Linode, etc.

  1. Access your server via shell (e.g. SSH)
  2. docker pull staltz/easy-ssb-pub
  3. docker run -e "PUB_URL=publicurltoyourserv.er" -e "PORT=80" -p 80:80 -p 8008:8008 -i -t staltz/easy-ssb-pub

Deploy without Docker

  1. Access your server via shell (e.g. SSH)
  2. Install nvm: curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash
  3. Restart the shell
  4. nvm install v6.9.1
  5. git clone https://github.com/staltz/easy-ssb-pub.git
  6. npm install
  7. PORT=80 PUB_URL="publicurltoyourserv.er" npm start

About

An easy-to-host server that runs an SSB "Pub"

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 67.2%
  • TypeScript 32.8%