]> git.mxchange.org Git - fba.git/blob - README.md
70ee9ef947236af4df09e2805c63404a90fa0780
[fba.git] / README.md
1 # Fedi block API
2
3 Used to see which instances block yours.
4
5 ## software used:
6
7 - python 3.10.2
8
9 ## Installation
10
11 ```bash
12 sudo useradd -m fba
13 sudo mkdir -p /opt/fedi-block-api
14 sudo chown -R fba:fba /opt/fedi-block-api
15 sudo -Hu fba git clone git://git.mxchange.org/fba.git /opt/fedi-block-api/
16 cd /opt/fedi-block-api/
17 sudo -Hu fba pip3 install -r requirements.txt
18 sudo -Hu fba cp blocks_empty.db blocks.db
19 sudo -Hu fba cp config.defaults.json config.json
20 sudo -Hu fba ./fba.py fetch_instances --domain=mastodon.social # try a bunch of large servers here
21 ```
22
23 ### Alter configuration file
24 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:
25
26 ```
27     "critical"
28     "error"
29     "warning"
30     "info"
31     "debug"
32     "trace"
33 ```
34
35 ### Install the services
36
37 ```bash
38 sudo cp services/* /etc/systemd/system
39 ```
40
41 ### start the services
42
43 ```bash
44 systemctl enable --now fetch_blocks
45 systemctl enable --now fedi_block_api
46 ```
47
48 ## Try it out
49
50 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.
51
52 ## License
53
54 [AGPLv3](https://gnu.org)