docs/commands.md

@@ -3,9 +3,9 @@
 There are a number of commands to manage your relay's database and config. You can add `--help` to
 any category or command to get help on that specific option (ex. `activityrelay inbox --help`).
 
-A config file can be specified by adding `--config [path/to/config.yaml]`.
+Note: Unless specified, it is recommended to run any commands while the relay is shutdown.
 
-Note: `activityrelay` is only available via pip or pipx if `~/.local/bin` is in `$PATH`. If it
+Note 2: `activityrelay` is only available via pip or pipx if `~/.local/bin` is in `$PATH`. If it
 isn't, use `python3 -m relay` if installed via pip or `~/.local/bin/activityrelay` if installed
 via pipx
 
@@ -24,35 +24,26 @@ Run the setup wizard to configure your relay.
 	activityrelay setup
 
 
-## Convert
-
-Convert an old `relay.yaml` and `relay.jsonld` to the newer formats.
-
-	activityrelay convert [--old-config relay.yaml]
-
-
 ## Config
 
-Manage the relay config.
+Manage the relay config
 
 	activityrelay config
 
 
 ### List
 
-List the current config key/value pairs.
+List the current config key/value pairs
 
 	activityrelay config list
 
 
 ### Set
 
-Set a value for a config option.
+Set a value for a config option
 
 	activityrelay config set <key> <value>
 
-note: The relay must be restarted if setting `log_level`, `workers`, `push_limit`, or `http_timeout`
-
 
 ## Inbox
 
@@ -101,32 +92,6 @@ not exist anymore, use the `inbox remove` command instead.
 Note: The relay must be running for this command to work.
 
 
-## Request
-
-Manage instance follow requests.
-
-
-### List
-
-List all instances asking to follow the relay.
-
-	activityrelay request list
-
-
-### Approve
-
-Allow an instance to join the relay.
-
-	activityrelay request approve <domain>
-
-
-### Deny
-
-Disallow an instance to join the relay.
-
-	activityrelay request deny <domain>
-
-
 ## Whitelist
 
 Manage the whitelisted domains.
@@ -155,7 +120,7 @@ Remove a domain from the whitelist.
 
 ### Import
 
-Add all current inboxes to the whitelist.
+Add all current inboxes to the whitelist
 
 	activityrelay whitelist import
 
@@ -167,7 +132,7 @@ Manage the instance ban list.
 
 ### List
 
-List the currently banned instances.
+List the currently banned instances
 
 	activityrelay instance list
 

docs/configuration.md

@@ -2,6 +2,14 @@
 
 ## General
 
+### DB
+
+The path to the database. It contains the relay actor private key and all subscribed
+instances. If the path is not absolute, it is relative to the working directory.
+
+	db: relay.jsonld
+
+
 ### Listener
 
 The address and port the relay will listen on. If the reverse proxy (nginx, apache, caddy, etc)
@@ -11,6 +19,46 @@ is running on the same host, it is recommended to change `listen` to `localhost`
 	port: 8080
 
 
+### Note
+
+A small blurb to describe your relay instance. This will show up on the relay's home page.
+
+	note: "Make a note about your instance here."
+
+
+### Post Limit
+
+The maximum number of messages to send out at once. For each incoming message, a message will be
+sent out to every subscribed instance minus the instance which sent the message. This limit
+is to prevent too many outgoing connections from being made, so adjust if necessary.
+
+Note: If the `workers` option is set to anything above 0, this limit will be per worker.
+
+	push_limit: 512
+
+
+### Push Workers
+
+The relay can be configured to use threads to push messages out. For smaller relays, this isn't
+necessary, but bigger ones (>100 instances) will want to set this to the number of available cpu
+threads.
+
+	workers: 0
+
+
+### JSON GET cache limit
+
+JSON objects (actors, nodeinfo, etc) will get cached when fetched. This will set the max number of
+objects to keep in the cache.
+
+	json_cache: 1024
+
+
+## AP
+
+Various ActivityPub-related settings
+
+
 ### Host
 
 The domain your relay will use to identify itself.
@@ -18,123 +66,40 @@ The domain your relay will use to identify itself.
 	host: relay.example.com
 
 
-## Database
+### Whitelist Enabled
 
-### Type
+If set to `true`, only instances in the whitelist can follow the relay. Any subscribed instances
+not in the whitelist will be removed from the inbox list on startup.
 
-The type of SQL database to use. Options:
+	whitelist_enabled: false
-
-* sqlite (default)
-* postgresql
-* mysql
-
-	type: sqlite
 
 
-### Minimum Connections
+### Whitelist
 
-The minimum number of database connections to keep open (does nothing at the moment)
+A list of domains of instances which are allowed to subscribe to your relay.
 
-	min_connections: 0
+	whitelist:
+	- bad-instance.example.com
+	- another-bad-instance.example.com
 
 
-### Maximum Connections
+### Blocked Instances
 
-The maximum number of database connections to open (does nothing at the moment)
+A list of instances which are unable to follow the instance. If a subscribed instance is added to
+the block list, it will be removed from the inbox list on startup.
 
-	max_connections: 10
+	blocked_instances:
+	- bad-instance.example.com
+	- another-bad-instance.example.com
 
 
-## Sqlite
+### Blocked Software
 
-### Database
+A list of ActivityPub software which cannot follow your relay. This list is empty by default, but
+setting this to the below list will block all other relays and prevent relay chains
 
-The path to the database file.
+	blocked_software:
-
+	- activityrelay
-	database: relay.sqlite3
+	- aoderelay
-
+	- social.seattle.wa.us-relay
-If the path is relative, it will be relative to the directory the config file is located. For
+	- unciarelay
-instance, if the config is located at `/home/izalia/.config/activityrelay/config.yaml`, the
-following:
-
-	relay.sqlite3
-
-will resolve to:
-
-	/home/izalia/.config/activityrelay/relay.sqlite3
-
-
-## PostgreSQL
-
-### Database
-
-Name of the database to use.
-
-	database: activityrelay
-
-
-### Hostname
-
-The address to use when connecting to the database. A value of `null` will use the default of
-`/var/run/postgresql`
-
-	hostname: null
-
-
-### Port
-
-The port to use when connecting to the database. A value of `null` will use the default of `5432`
-
-	port: null
-
-
-### Username
-
-The user to use when connecting to the database. A value of `null` will use the current system
-username.
-
-	username: null
-
-
-### Password
-
-The password for the database user.
-
-	password: null
-
-
-## MySQL
-
-### Database
-
-Name of the database to use.
-
-	database: activityrelay
-
-
-### Hostname
-
-The address to use when connecting to the database. A value of `null` will use the default of
-`/var/run/mysqld/mysqld.sock`
-
-
-### Port
-
-The port to use when connecting to the database. A value of `null` will use the default of `3306`
-
-	port: null
-
-
-### Username
-
-The user to use when connecting to the database. A value of `null` will use the current system
-username.
-
-	username: null
-
-
-### Password
-
-The password for the database user.
-
-	password: null

docs/installation.md

@@ -5,19 +5,6 @@ proxy, and setup the relay to run via a supervisor. Example configs for caddy, n
 in `installation/`
 
 
-## Pre-build Executables
-
-All in one executables can be downloaded from `https://git.pleroma.social/pleroma/relay/-/releases`
-under the `Other` section of `Assets`. They don't require any extra setup and can be placed
-anywhere. Run the setup wizard
-
-	./activityrelay setup
-
-and start it up when done
-
-	./activityrelay run
-
-
 ## Pipx
 
 Pipx uses pip and a custom venv implementation to automatically install modules into a Python

relay.yaml.example

@@ -1,9 +1,9 @@
 general:
   # Address the relay will listen on. Set to "0.0.0.0" for any address
   listen: 0.0.0.0
-  # TCP port the relay will listen on
+  # Port the relay will listen on
   port: 3621
-  # Domain the relay will advertise itself as
+  # Domain the relay will advertise as
   host: relay.example.com
 
 database:
@@ -14,9 +14,6 @@ database:
   # Maximum number of database connections to open
   max_connections: 10
 
-sqlite:
-  database: relay.sqlite3
-
 postgres:
   database: activityrelay
   hostname: null

relay/application.py

@@ -40,6 +40,7 @@ class Application(web.Application):
 		self['last_worker'] = 0
 
 		self.database.create()
+		self.set_signal_handler()
 
 		with self.database.session as s:
 			set_level(s.get_config('log_level'))
@@ -97,10 +98,10 @@ class Application(web.Application):
 			self['last_worker'] = 0
 
 
-	def set_signal_handler(self, enable=True):
+	def set_signal_handler(self):
 		for sig in {'SIGHUP', 'SIGINT', 'SIGQUIT', 'SIGTERM'}:
 			try:
-				signal.signal(getattr(signal, sig), self.stop if enable else signal.SIG_DFL)
+				signal.signal(getattr(signal, sig), self.stop)
 
 			# some signals don't exist in windows, so skip them
 			except AttributeError:
@@ -128,7 +129,6 @@ class Application(web.Application):
 
 
 	async def handle_run(self):
-		self.set_signal_handler(True)
 		self['running'] = True
 
 		with self.database.session as s:
@@ -161,7 +161,6 @@ class Application(web.Application):
 		self['starttime'] = None
 		self['running'] = False
 		self['workers'].clear()
-		self.set_signal_handler(False)
 
 
 class PushWorker(threading.Thread):

relay/config.py

@@ -1,10 +1,10 @@
+import appdirs
 import os
 import sys
 import yaml
 
 from functools import cached_property
 from pathlib import Path
-from platform import system
 
 from .misc import AppBase, DotDict
 
@@ -16,7 +16,6 @@ DEFAULTS = {
 	'database_type': 'sqlite',
 	'database_min_connections': 0,
 	'database_max_connections': 10,
-	'sqlite_database': Path('relay.sqlite3'),
 	'postgres_database': 'activityrelay',
 	'postgres_hostname': None,
 	'postgres_port': None,
@@ -32,40 +31,30 @@ DEFAULTS = {
 CATEGORY_NAMES = [
 	'general',
 	'database',
-	'sqlite',
 	'postgres',
 	'mysql'
 ]
 
+CONFIG_DIRS = [
+	Path.cwd(),
+	Path(appdirs.user_config_dir('activityrelay'))
+]
+
 
 def get_config_dir():
-	cwd = Path.cwd().joinpath('config.yaml')
+	for path in CONFIG_DIRS:
-	plat = system()
+		cfgpath = path.joinpath('config.yaml')
-
-	if cwd.exists():
-		return cwd
-
-	elif plat == 'Linux':
-		cfgpath = Path('~/.config/activityrelay/config.yaml').expanduser()
 
 		if cfgpath.exists():
 			return cfgpath
 
+	if sys.platform == 'linux':
 		etcpath = Path('/etc/activityrelay/config.yaml')
 
-		if etcpath.exists() and os.getuid() == etcpath.stat().st_uid:
+		if etcpath.exists():
-			return etcpath
-
-	elif plat == 'Windows':
-		cfgpath = Path('~/AppData/Roaming/activityrelay/config.yaml').expanduer()
-
-		if cfgpath.exists():
 			return cfgpath
 
-	elif plat == 'Darwin':
+	return Path.cwd().joinpath('config.yaml')
-		cfgpath = Path('~/Library/Application Support/activityaelay/config.yaml')
-
-	return cwd
 
 
 class Config(AppBase, dict):
@@ -79,26 +68,19 @@ class Config(AppBase, dict):
 			path = get_config_dir()
 
 		else:
-			path = Path(path).expanduser()
+			path = Path(path).expanduser().resolve()
 
 		self._path = path
 		self.load()
 
 
 	def __setitem__(self, key, value):
-		if key in {'database', 'hostname', 'port', 'username', 'password'}:
-			key = f'{self.dbtype}_{key}'
-
 		if (self.is_docker and key in {'general_host', 'general_port'}) or value == '__DEFAULT__':
 			value = DEFAULTS[key]
 
 		elif key in {'general_port', 'database_min_connections', 'database_max_connections'}:
 			value = int(value)
 
-		elif key == 'sqlite_database':
-			if not isinstance(value, Path):
-				value = Path(value)
-
 		dict.__setitem__(self, key, value)
 
 
@@ -111,11 +93,7 @@ class Config(AppBase, dict):
 		}
 
 		if self.dbtype == 'sqlite':
-			if not self['sqlite_database'].is_absolute():
+			config['database'] = self.path.with_name('relay.sqlite3')
-				config['database'] = self.path.with_name(str(self['sqlite_database'])).resolve()
-
-			else:
-				config['database'] = self['sqlite_database'].resolve()
 
 		else:
 			for key, value in self.items():

relay/database.py

@@ -1,10 +1,91 @@
 import tinysql
 
 from datetime import datetime
+from tinysql import Column, Table
 from urllib.parse import urlparse
 
-from .base import DEFAULT_CONFIG
+from .logger import set_level
-from ..misc import DotDict
+from .misc import AppBase, DotDict, boolean
+
+
+TABLES = [
+	Table('config',
+		Column('key', 'text', unique=True, nullable=False, primary_key=True),
+		Column('value', 'text')
+	),
+	Table('instances',
+		Column('id', 'serial'),
+		Column('domain', 'text', unique=True, nullable=False),
+		Column('actor', 'text'),
+		Column('inbox', 'text', nullable=False),
+		Column('followid', 'text'),
+		Column('software', 'text'),
+		Column('actor_data', 'json'),
+		Column('note', 'text'),
+		Column('joined', 'datetime', nullable=False),
+		Column('updated', 'datetime')
+	),
+	Table('whitelist',
+		Column('id', 'serial'),
+		Column('domain', 'text', unique=True),
+		Column('created', 'datetime', nullable=False)
+	),
+	Table('bans',
+		Column('id', 'serial'),
+		Column('name', 'text', unique=True),
+		Column('note', 'text'),
+		Column('type', 'text', nullable=False),
+		Column('created', 'datetime', nullable=False)
+	),
+	Table('users',
+		Column('id', 'serial'),
+		Column('handle', 'text', unique=True, nullable=False),
+		Column('domain', 'text', nullable=False),
+		Column('api_token', 'text'),
+		Column('created', 'datetime', nullable=False),
+		Column('updated', 'datetime')
+	),
+	Table('tokens',
+		Column('id', 'text', unique=True, nullable=False, primary_key=True),
+		Column('userid', 'integer', nullable=False),
+		Column('created', 'datetime', nullable=False),
+		Column('updated', 'datetime')
+	)
+]
+
+DEFAULT_CONFIG = {
+	'description': ('str', 'Make a note about your relay here'),
+	'http_timeout': ('int', 10),
+	'json_cache': ('int', 1024),
+	'log_level': ('str', 'INFO'),
+	'name': ('str', 'ActivityRelay'),
+	'privkey': ('str', ''),
+	'push_limit': ('int', 512),
+	'require_approval': ('bool', False),
+	'version': ('int', 20221211),
+	'whitelist': ('bool', False),
+	'workers': ('int', 8)
+}
+
+RELAY_SOFTWARE = [
+	'activityrelay', # https://git.pleroma.social/pleroma/relay
+	'aoderelay', # https://git.asonix.dog/asonix/relay
+	'feditools-relay' # https://git.ptzo.gdn/feditools/relay
+]
+
+
+class Database(AppBase, tinysql.Database):
+	def __init__(self, **config):
+		tinysql.Database.__init__(self, **config,
+			connection_class = Connection,
+			row_classes = [
+				ConfigRow
+			]
+		)
+
+
+	def create(self):
+		self.create_database(TABLES)
 
 
 class Connection(tinysql.ConnectionMixin):
@@ -82,12 +163,12 @@ class Connection(tinysql.ConnectionMixin):
 		if not row:
 			return DEFAULT_CONFIG[key][1]
 
-		return row.value
+		return row.get_value()
 
 
 	def get_config_all(self):
 		rows = self.select('config').all()
-		config = DotDict({row.key: row.value for row in rows})
+		config = DotDict({row.key: row.get_value() for row in rows})
 
 		for key, data in DEFAULT_CONFIG.items():
 			if key not in config:
@@ -166,8 +247,8 @@ class Connection(tinysql.ConnectionMixin):
 		if value == '__DEFAULT__':
 			value = DEFAULT_CONFIG[key][1]
 
-		elif key == 'log_level' and not getattr(logging, value.upper(), False):
+		if key == 'log_level':
-			raise KeyError(value)
+			set_level(value)
 
 		row = self.select('config', key=key).one()
 
@@ -237,3 +318,24 @@ class Connection(tinysql.ConnectionMixin):
 			'domain': domain,
 			'created': datetime.now()
 		})
+
+
+class ConfigRow(tinysql.Row):
+	__table__ = 'config'
+
+	def get_value(self):
+		type = DEFAULT_CONFIG[self.key][0]
+
+		if type == 'int':
+			return int(self.value)
+
+		elif type == 'bool':
+			return boolean(self.value.encode('utf-8'))
+
+		elif type == 'list':
+			return json.loads(value)
+
+		elif type == 'json':
+			return DotDict.parse(value)
+
+		return self.value

relay/database/__init__.py

@@ -1,17 +0,0 @@
-import tinysql
-
-from .base import DEFAULT_CONFIG, RELAY_SOFTWARE, TABLES
-from .connection import Connection
-from .rows import ROWS
-
-
-class Database(tinysql.Database):
-	def __init__(self, **config):
-		tinysql.Database.__init__(self, **config,
-			connection_class = Connection,
-			row_classes = ROWS
-		)
-
-
-	def create(self):
-		self.create_database(TABLES)

relay/database/base.py

@@ -1,67 +0,0 @@
-from tinysql import Column, Table
-
-
-DEFAULT_CONFIG = {
-	'description': ('str', 'Make a note about your relay here'),
-	'http_timeout': ('int', 10),
-	'json_cache': ('int', 1024),
-	'log_level': ('str', 'INFO'),
-	'name': ('str', 'ActivityRelay'),
-	'privkey': ('str', ''),
-	'push_limit': ('int', 512),
-	'require_approval': ('bool', False),
-	'version': ('int', 20221211),
-	'whitelist': ('bool', False),
-	'workers': ('int', 8)
-}
-
-RELAY_SOFTWARE = [
-	'activity-relay', # https://github.com/yukimochi/Activity-Relay
-	'activityrelay', # https://git.pleroma.social/pleroma/relay
-	'aoderelay', # https://git.asonix.dog/asonix/relay
-	'feditools-relay' # https://git.ptzo.gdn/feditools/relay
-]
-
-TABLES = [
-	Table('config',
-		Column('key', 'text', unique=True, nullable=False, primary_key=True),
-		Column('value', 'text')
-	),
-	Table('instances',
-		Column('id', 'serial'),
-		Column('domain', 'text', unique=True, nullable=False),
-		Column('actor', 'text'),
-		Column('inbox', 'text', nullable=False),
-		Column('followid', 'text'),
-		Column('software', 'text'),
-		Column('note', 'text'),
-		Column('joined', 'datetime', nullable=False),
-		Column('updated', 'datetime')
-	),
-	Table('whitelist',
-		Column('id', 'serial'),
-		Column('domain', 'text', unique=True),
-		Column('created', 'datetime', nullable=False)
-	),
-	Table('bans',
-		Column('id', 'serial'),
-		Column('name', 'text', unique=True),
-		Column('note', 'text'),
-		Column('type', 'text', nullable=False),
-		Column('created', 'datetime', nullable=False)
-	),
-	Table('users',
-		Column('id', 'serial'),
-		Column('handle', 'text', unique=True, nullable=False),
-		Column('domain', 'text', nullable=False),
-		Column('api_token', 'text'),
-		Column('created', 'datetime', nullable=False),
-		Column('updated', 'datetime')
-	),
-	Table('tokens',
-		Column('id', 'text', unique=True, nullable=False, primary_key=True),
-		Column('userid', 'integer', nullable=False),
-		Column('created', 'datetime', nullable=False),
-		Column('updated', 'datetime')
-	)
-]

relay/database/rows.py

@@ -1,35 +0,0 @@
-import json
-from tinysql import Row
-from .base import DEFAULT_CONFIG
-from ..misc import DotDict, boolean
-
-
-ROWS = []
-
-
-def register(cls):
-	ROWS.append(cls)
-	return cls
-
-
-@register
-class ConfigRow(Row):
-	__table__ = 'config'
-
-	@property
-	def value(self):
-		type = DEFAULT_CONFIG[self.key][0]
-
-		if type == 'int':
-			return int(self['value'])
-
-		elif type == 'bool':
-			return boolean(self['value'])
-
-		elif type == 'list':
-			return json.loads(self['value'])
-
-		elif type == 'json':
-			return DotDict.parse(self['value'])
-
-		return self['value']

relay/manage.py

@@ -31,9 +31,6 @@ def cli(ctx, config):
 	global app
 	app = Application(config)
 
-	if ctx.invoked_subcommand != 'convert':
-		app.setup()
-
 	if not ctx.invoked_subcommand:
 		if app.config.host.endswith('example.com'):
 			cli_setup.callback()
@@ -41,12 +38,13 @@ def cli(ctx, config):
 		else:
 			cli_run.callback()
 
+	if ctx.invoked_subcommand != 'convert':
+		app.setup()
+
 
 @cli.command('convert')
 @click.option('--old-config', '-o', help='path to the old relay config')
 def cli_convert(old_config):
-	'Convert an old relay.yaml and relay.jsonld to the the new formats'
-
 	with open(old_config or 'relay.yaml') as fd:
 		config = yaml.load(fd.read(), Loader=yaml.SafeLoader)
 		ap = config.get('ap', {})
@@ -108,10 +106,7 @@ def cli_setup():
 	'Generate a new config'
 
 	while True:
-		app.config['general_host'] = click.prompt(
+		app.config['general_host'] = click.prompt('What domain will the relay be hosted on?', default=app.config.host)
-			'What domain will the relay be hosted on?',
-			default = app.config.host
-		)
 
 		if not app.config.host.endswith('example.com'):
 			break
@@ -119,60 +114,12 @@ def cli_setup():
 		click.echo('The domain must not be example.com')
 
 	if not app.config.is_docker:
-		app.config['general_listen'] = click.prompt(
+		app.config['general_listen'] = click.prompt('Which address should the relay listen on?', default=app.config.listen)
-			'Which address should the relay listen on?',
-			default = app.config.listen
-		)
 
 		while True:
-			app.config['general_port'] = click.prompt(
+			app.config['general_port'] = click.prompt('What TCP port should the relay listen on?', default=app.config.port, type=int)
-				'What TCP port should the relay listen on?',
-				default = app.config.port,
-				type = int
-			)
-
 			break
 
-	app.config['database_type'] = click.prompt(
-		'What database backend would you like to use for the relay?',
-		default = app.config.dbtype,
-		type = click.Choice(['sqlite', 'postgresql', 'mysql']),
-		show_choices = True
-	)
-
-	if app.config.dbtype == 'sqlite':
-		app.config['sqlite_database'] = click.prompt(
-			'Where would you like to store your database file? Relative paths are relative to the config file location.',
-			default = app.config['sqlite_database']
-		)
-
-	else:
-		dbconfig = app.config.dbconfig
-		app.config.hostname = click.prompt(
-			'What address is your database listening on?',
-			default = dbconfig.hostname
-		) or None
-
-		app.config.port = click.prompt(
-			'What port is your database listening on?',
-			default = dbconfig.port
-		) or None
-
-		app.config.database = click.prompt(
-			'What would you like the name of the database be?',
-			default = dbconfig.database
-		) or None
-
-		app.config.username = click.prompt(
-			'Which user will be connecting to the database?',
-			default = dbconfig.username
-		) or None
-
-		app.config.password = click.prompt(
-			'What is the database user\'s password?',
-			default = dbconfig.password
-		) or None
-
 	app.config.save()
 
 	with app.database.session as s:

requirements.txt

@@ -1,4 +1,5 @@
 aiohttp>=3.8.0
+appdirs>=1.4.4
 aputils@https://git.barkshark.xyz/barkshark/aputils/archive/0.1.3.tar.gz
 cachetools>=5.2.0
 click>=8.1.2