Go to file
Tao Bror Bojlén 2de412bfbb
prepare for 2.1.0 release
2019-07-24 13:19:24 +03:00
.vscode Refactor graph sidebar, move to backend search 2019-07-23 12:20:34 +00:00
backend prepare for 2.1.0 release 2019-07-24 13:19:24 +03:00
frontend prepare for 2.1.0 release 2019-07-24 13:19:24 +03:00
gephi frontend/cytoscape feature parity 2019-07-19 18:19:53 +00:00
.dokku-monorepo fix backend app name in .dokku-monorepo 2019-07-14 13:12:35 +01:00
.gitignore frontend/cytoscape feature parity 2019-07-19 18:19:53 +00:00
.gitlab-ci.yml Update .gitlab-ci.yml 2019-07-20 17:49:32 +00:00
BILL-OF-MATERIALS.md prepare for 2.0.0 release 2019-07-20 13:01:56 +03:00
CHANGELOG.md prepare for 2.1.0 release 2019-07-24 13:19:24 +03:00
LICENSE use AGPL (#32) 2019-02-20 13:45:09 +00:00
README.md show robots.txt status in frontend 2019-07-20 17:43:37 +00:00
docker-compose.yml consolidate into one docker-compose.yml 2019-07-14 14:40:35 +01:00
example.env refactor/elixir backend 2019-07-14 11:47:06 +00:00
netlify.toml fix direct links on netlify 2019-07-21 10:23:50 +03:00
screenshot.png add deployment instructions to README 2019-07-20 13:45:34 +03:00

README.md

fediverse.space 🌐

The map of the fediverse that you always wanted.

Read the latest updates on Mastodon: @fediversespace

A screenshot of fediverse.space

  1. Requirements
  2. Running it
  3. Commands
  4. Privacy
  5. Deployment
  6. Acknowledgements

Requirements

Though dockerized, backend development is easiest if you have the following installed.

  • For the scraper + API:
    • Elixir
    • Postgres
  • For laying out the graph:
    • Java
  • For the frontend:
    • Node.js
    • Yarn

Running it

Backend

  • cp example.env .env and modify environment variables as required
  • docker-compose build
  • docker-compose up -d phoenix
    • if you don't specify phoenix, it'll also start gephi which should only be run as a regular one-off job

Frontend

  • cd frontend && yarn install
  • yarn start

Commands

Backend

./gradlew shadowJar compiles the graph layout program. java -Xmx1g -jar build/libs/graphBuilder.jar runs it. If running in docker, this means you run

  • docker-compose build gephi
  • docker-compose run gephi java -Xmx1g -jar build/libs/graphBuilder.jar lays out the graph

Frontend

  • yarn build creates an optimized build for deployment

Privacy

This project doesn't crawl personal instances: the goal is to understand communities, not individuals. The threshold for what makes an instance "personal" is defined in the backend config and the graph builder SQL.

Deployment

You don't have to follow these instructions, but it's one way to set up a continuous deployment pipeline. The following are for the backend; the frontend is just a static HTML/JS site that can be deployed anywhere.

  1. Install Dokku on your web server.
  2. Install dokku-postgres, dokku-monorepo, and dokku-letsencrypt.
  3. Create the apps
  • dokku apps:create phoenix
  • dokku apps:create gephi
  1. Create the backing database
  • dokku postgres:create fediversedb
  • dokku postgres:link fediversedb phoenix
  • dokku postgres:link fediversedb gephi
  1. Update the backend configuration. In particular, change the user_agent in config.exs to something descriptive.
  2. Push the apps, e.g. git push dokku@<DOMAIN>:phoenix (note that the first push cannot be from the CD pipeline).
  3. Set up SSL for the Phoenix app
  • dokku letsencrypt phoenix
  • dokku letsencrypt:cron-job --add
  1. Set up a cron job for the graph layout (use the dokku user). E.g.
SHELL=/bin/bash
0 2 * * * /usr/bin/dokku run gephi java -Xmx1g -jar build/libs/graphBuilder.jar

Acknowledgements

NLnet logo

Many thanks to NLnet for their support and guidance of this project.