faery-ring/README.md

5.5 KiB

Faery Ring

An ultra-lightweight js-free server-side webring implementation

Webrings are a way of building a community especially popular with amateur websites. Here's how it works: Each member of the webring includes a link to a "next" website and a "previous" website, creating something like a "ring", hence the name. Anyone who finds their way onto one website can organically navigate to other pages in the ring.

Although they were first used to drive traffic in the era before search engines, many folks now see webrings as a way of building cozy communities on the web, or as a way to bring back the exciting feeling of the web as a place to be explored.

Where does Faery Ring come in? To make it easier to maintain webrings as they grow and change, many people employ simple scripts to coordinate member pages. Faery Ring lets you do this without needing JavaScript

Faery Ring might be right for you if...

  • You want to start a webring, but you or someone in your ring really doesn't like JavaScript
  • One of the member pages on your webring can't use JavaScript because of hosting limitations
  • You want to make it as easy as possible for new members to join your webring
  • You have your own dedicated server or virtual private server (VPS)

Faery Ring might not be right for you if...

Faery Ring is made for a pretty particular usecase, which might not necessarily fit your own. If you don't think that Faery Ring will work for you, that's okay! We encourage you to check out other projects, like maybe onionring.js, a similar project that works using static javascript files. If you know any other webring projects that we should list here, submit an issue and we can add them too!

You want more features provided by default

Faery Ring only provides a "next" link and a "previous" link by default. Features like an index page, premade widgets, and script integration is something you'll have to bring yourself.

You don't have a place to host dynamic web content

Faery Ring needs a place to run it's webserver, and many ringmasters (that's the person who runs a webring) might only have the ability to serve static files

Your server isn't running Linux

There is no reason why Faery Ring can't run on other operating systems, but unfortunately I have no way of testing this, so I can't guarantee that it will work, and you may need to build the binary yourself. If that's okay with you, go right ahead though!

You or a ring member is a non-cooperative corporation, cop, or planning on doing bad things

Faery Rings is dual-licensed under the CNPL and FAFOL, which forbids the use of Faery Ring for a number of distasteful purposes. If you're worried that your purposes might be considered distasteful, first, ask yourself why you think that might be, and if you should be doing that. Then, check out the CNPL website for more details. If that's all a bit much for you, you're welcome to use the license under the FAFOL (Fuck Around and Find Out License) - a license very similar to the MIT license. The FAFOL also restricts unethical use, but as long as your use is generally good (not evil) you're in the clear.

How do I use it??

Running Faery Ring is pretty easy. First, make a .txt file somewhere, and fill it with all of the sites in your ring, one per line. Leave out the protocol (https://) and a trailing slash, so that it looks something like this:

www.dragoness.space
emii.gay
garlic.garden/onionring
queerings.gay
getonflop.xyz

One restriction: If one site is a substring of another, the shorter site must go first. For example, if you have unix.pub and unix.pub/~user, unix.pub MUST be higher in the list than unix.pub/~user

Now, run the Faery Ring binary (or docker image) with the .txt file you just created as the first argument, like this:

# Run from the binary
faery-ring /path/to/domains.txt

# Or run using Docker
docker run -v /path/to/domains.txt:/domains.txt -p 3243:3243 alch0emi/faery-ring

You can also use the -p <port> flag to tell faery-ring what port you want to bind on. If you don't, it'll pick port 3243. Anyway, now you can point your webserver at Faery Ring! The config below is for Caddy, but any webserver that supports reverse proxies will work!

your.web.site {
    reverse_proxy /next/* localhost:3243
    reverse_proxy /prev/* localhost:3243
}

Now your webring members can add links on their page to https://your.web.site/next/\<their\_domain> https://your.web.site/prev/\<their\_domain> in order to build the ring. For example, whoever runs the page at www.dragoness.space would add a link to https://your.web.site/next/www.dragoness.space and https://your.web.site/prev/www.dragoness.space. garlic.garden/onionring cen either use /next/garlic.garden or /next/garlic.garden/onionring. If more than one site were hosted on garlic.garden, then the second form would be required.

Downloads

  • Linux binaries are available from the releases page
  • A docker image is available on Docker Hub under alch0emi/faery-ring:v0.1.0
  • If you have cargo installed on your system, faery ring can be installed with cargo install --git https://fem.mint.lgbt/Emi/faery-ring.git

Webrings that use faery-ring

Do you run a webring that uses faery ring? I'd love to know, and add you to the list if you'd like! 💜