X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=README.md;h=f0fb65c5d8d12fb957e41d1a6cb9da8493eceef9;hb=92a6263c5be5992e094bcab62821a1eb437a5767;hp=e90aa5b390b51114fc984ff9c6df98f5bbee3d99;hpb=19abc18f903c28f57ad357858fb4dd2bd3a65f50;p=fba.git diff --git a/README.md b/README.md index e90aa5b..f0fb65c 100644 --- a/README.md +++ b/README.md @@ -3,28 +3,61 @@ Used to see which instances block yours. ## software used: + - python 3.10.2 -- node v17.6.0 -- yarn 1.22.17 -## how to use: +## Installation + +```bash +sudo useradd -m fba +sudo mkdir -p /opt/fedi-block-api +sudo chown -R fba:fba /opt/fedi-block-api +sudo -Hu fba git clone git://git.mxchange.org/fba.git /opt/fedi-block-api/ +cd /opt/fedi-block-api/ +sudo -Hu fba pip3 install -r requirements.txt +sudo -Hu fba cp blocks_empty.db blocks.db +sudo -Hu fba cp config.defaults.json config.json +sudo -Hu fba ./fba.py fetch_instances --domain=mastodon.social # try a bunch of large servers here +``` -Copy the preloaded database to the live database +### Alter configuration file +You maybe wish to change the configuration file, e.g. log_level is set to "info" which is the default but invates privacy of your users, but your choice: -`cp blocks_preloaded.db blocks.db` +``` + "critical" + "error" + "warning" + "info" + "debug" + "trace" +``` -Start the mastodon API +### Fetch blocklists locally (WIP) +To save yourself bandwidth and codeberg, too, you want to clone the blocklists from some folks: ``` -cd mastodon_api -yarn install -node . +sudo -Hu fba git clone https://codeberg.org/oliphant/blocklists.git blocklists/oliphant/ +``` + +WIP notice: This feature is not implemented yet. + +### Install the services + +```bash +sudo cp services/* /etc/systemd/system +``` + +### start the services + +```bash +systemctl enable --now fetch_blocks +systemctl enable --now fedi_block_api ``` -Fill the database with blocks. +## Try it out -`python fetch_blocks.py` +https://fba.ryona.agency/ uses an older code than this one. So it doesn't reflect this code here. My FBA sub-domain is currently password-protected as I still need to fix some performance issues with large blocking lists. ## License -[AGPLv3+NIGGER](https://plusnigger.autism.exposed/) \ No newline at end of file +[AGPLv3](https://gnu.org)