the-federation.info's Introduction

The-Federation.info

Statistics hub and node list for The Federation (diaspora*, Friendica, Hubzilla).

Requirements

Node 4.x
Python 3.x
MySQL/MariaDB

Database creation

Something like this:

create database diasporahub;
create user diasporahub@localhost identified by 'putnicepasswordhere';
grant all on diasporahub.* to diasporahub@localhost;

Copy src/config.js.example to src/config.js and edit proper values there.

Installation

Node

The 4.x LTS version has been tested. For Ubuntu, follow this guide. Other systems follow NodeJS docs.

Install then the Node packages

npm install

Python

Python 3 should hopefully be shipped in your system, if not, install it.

Create a virtualenv using the Python 3 executable and activate it.

The Python dependencies need some system packages. For Ubuntu, this will work, for other systems, find the relevant packages and install.

sudo apt-get install python3-dev libmysqlclient-dev

Install dependencies in your activated virtualenv:

pip install -r python-requirements.txt

Running

Make sure correct Python virtualenv is active. Then in the application abse directory;

node src/app.js

The app will be running at http://127.0.0.1:4730. You can change the port in the src/config.js file if you want.

We need data

Things wont look nice without any data, so register a node, for example this in a browser:

http://127.0.0.1:4730/register/iliketoast.net

Check the front page and there should be a node listed.

Development

Sass

If you want to touch the CSS part of the-federation, you need to modify the .scss files in static/stylesheet and then compile site.scss to site.css. There is a node compiler or a python compiler. More about the Sass extension of the CSS language.