2016-02-14 10:10:21 +01:00
|
|
|
# Values formatted like "_env:ENV_VAR_NAME:default_value" can be overridden by
|
|
|
|
# the specified environment variable. See the Yesod wiki, Configuration page.
|
2016-02-13 04:35:30 +01:00
|
|
|
|
2018-02-25 10:25:24 +01:00
|
|
|
###############################################################################
|
|
|
|
# HTTP server
|
|
|
|
###############################################################################
|
|
|
|
|
2016-02-14 10:10:21 +01:00
|
|
|
# any IPv4 host
|
|
|
|
host: "_env:HOST:*4"
|
|
|
|
|
|
|
|
# The port `yesod devel` uses is distinct from this value. Set the
|
|
|
|
# `yesod devel` port from the command line.
|
2016-03-05 04:56:25 +01:00
|
|
|
http-port: "_env:PORT:3000"
|
2016-02-14 10:10:21 +01:00
|
|
|
|
2016-02-13 04:35:30 +01:00
|
|
|
ip-from-header: "_env:IP_FROM_HEADER:false"
|
|
|
|
|
2024-10-19 13:28:53 +02:00
|
|
|
# The instance's host (e.g. "mycoolforge.org"). Used for determining which
|
2019-03-16 18:15:31 +01:00
|
|
|
# requests are federated and which are for this instance, and for generating
|
|
|
|
# URLs. The database relies on this value, and you shouldn't change it once
|
|
|
|
# you deploy an instance.
|
2024-10-19 13:28:53 +02:00
|
|
|
instance-host: "_env:INSTANCE_HOST:dev.example.org"
|
2019-03-04 10:06:23 +01:00
|
|
|
|
2018-07-01 10:15:23 +02:00
|
|
|
# How much time after the last request it takes for the session cookie to
|
|
|
|
# expire
|
|
|
|
client-session-timeout:
|
2024-10-19 13:28:53 +02:00
|
|
|
amount: 60
|
|
|
|
unit: days
|
2018-07-01 10:15:23 +02:00
|
|
|
|
2019-01-14 23:08:44 +01:00
|
|
|
# Maximal accepted time difference between request date and current time, when
|
|
|
|
# performing this check during HTTP signature verification
|
|
|
|
request-time-limit:
|
|
|
|
amount: 5
|
2019-01-19 02:06:09 +01:00
|
|
|
unit: minutes
|
2019-01-14 23:08:44 +01:00
|
|
|
|
|
|
|
# How often to generate a new actor key for HTTP-signing requests
|
|
|
|
actor-key-rotation:
|
|
|
|
amount: 1
|
2019-02-08 00:28:39 +01:00
|
|
|
unit: days
|
2019-01-14 23:08:44 +01:00
|
|
|
|
Improve the AP async HTTP delivery API and per-actor key support
New iteration of the ActivityPub delivery implementation and interface.
Advantages over previous interface:
* When sending a ByteString body, the sender is explicitly passed as a
parameter instead of JSON-parsing it out of the ByteString
* Clear 3 operations provided: Send, Resend and Forward
* Support for per-actor keys
* Actor-type-specific functions (e.g. deliverRemoteDB_D) removed
* Only the most high-level API is exposed to Activity handler code, making
handler code more concise and clear
Also added in this patch:
* Foundation for per-actor key support
* 1 key per actor allowed in DB
* Disabled C2S and S2S handlers now un-exported for clarity
* Audience and capability parsing automatically done for all C2S handlers
* Audience and activity composition automatically done for Vervis.Client
builder functions
Caveats:
* Actor documents still don't link to their per-actor keys; that should be the
last piece to complete per-actor key support
* No moderation and anti-spam tools yet
* Delivery API doesn't yet have good integration of persistence layer, e.g.
activity is separately encoded into bytestring for DB and for HTTP; this will
be improved in the next iteration
* Periodic delivery now done in 3 separate steps, running sequentially; it
simplifies the code, but may be changed for efficiency/robustness in the next
iterations
* Periodic delivery collects per-actor keys in a
1-DB-transaction-for-each-delivery fashion, rather than grabbing them in the
big Esqueleto query (or keeping the signed output in the DB; this isn't done
currently to allow for smooth actor key renewal)
* No support yet in the API for delivery where the actor key has already been
fetched, rather than doing a DB transaction to grab it; such support would be
just an optimization, so it's low-priority, but will be added in later
iterations
2022-10-12 18:50:11 +02:00
|
|
|
# Whether to use personal actor keys, or an instance-wide key
|
|
|
|
per-actor-keys: false
|
|
|
|
|
2018-02-25 10:25:24 +01:00
|
|
|
###############################################################################
|
|
|
|
# Development
|
|
|
|
###############################################################################
|
|
|
|
|
2016-02-13 04:35:30 +01:00
|
|
|
# Optional values with the following production defaults.
|
|
|
|
# In development, they default to the inverse.
|
|
|
|
#
|
|
|
|
# development: false
|
|
|
|
# detailed-logging: false
|
|
|
|
# should-log-all: false
|
|
|
|
# mutable-static: false
|
|
|
|
|
2024-07-18 12:57:41 +02:00
|
|
|
# This setting isn't used anymore (because no more need for SVG fonts)
|
2018-05-26 12:27:05 +02:00
|
|
|
# load-font-from-lib-data: false
|
|
|
|
|
2018-02-25 10:25:24 +01:00
|
|
|
###############################################################################
|
2023-05-25 00:17:14 +02:00
|
|
|
# Database
|
2018-02-25 10:25:24 +01:00
|
|
|
###############################################################################
|
|
|
|
|
2016-02-14 10:10:21 +01:00
|
|
|
# If you need a numeric value (e.g. 123) to parse as a String, wrap it in
|
|
|
|
# single quotes (e.g. "_env:PGPASS:'123'"). See the Yesod wiki, Configuration
|
|
|
|
# page.
|
2016-02-13 04:35:30 +01:00
|
|
|
|
|
|
|
database:
|
2024-10-19 13:28:53 +02:00
|
|
|
user: "_env:PGUSER:vervis"
|
|
|
|
password: "_env:PGPASS:abc123"
|
|
|
|
host: "_env:PGHOST:db"
|
2016-02-13 04:35:30 +01:00
|
|
|
port: "_env:PGPORT:5432"
|
2024-10-19 13:28:53 +02:00
|
|
|
database: "_env:PGDATABASE:vervis_production"
|
2016-02-13 04:35:30 +01:00
|
|
|
poolsize: "_env:PGPOOLSIZE:10"
|
|
|
|
|
2019-02-24 02:35:07 +01:00
|
|
|
max-instance-keys: 2
|
|
|
|
max-actor-keys: 2
|
|
|
|
|
2024-10-15 23:32:54 +02:00
|
|
|
state-dir: state
|
2023-05-25 00:17:14 +02:00
|
|
|
|
2018-02-25 10:25:24 +01:00
|
|
|
###############################################################################
|
|
|
|
# Version control repositories
|
|
|
|
###############################################################################
|
|
|
|
|
2018-05-21 22:32:34 +02:00
|
|
|
diff-context-lines: 5
|
2024-10-19 13:28:53 +02:00
|
|
|
post-receive-hook: /app/vervis-post-receive
|
|
|
|
post-apply-hook: /app/vervis-post-apply
|
2018-02-25 10:25:24 +01:00
|
|
|
|
|
|
|
###############################################################################
|
|
|
|
# SSH server
|
|
|
|
###############################################################################
|
|
|
|
|
2016-03-05 04:56:25 +01:00
|
|
|
ssh-port: 5022
|
2018-02-25 10:25:24 +01:00
|
|
|
|
|
|
|
###############################################################################
|
|
|
|
# Accounts
|
|
|
|
###############################################################################
|
|
|
|
|
2016-04-19 18:03:27 +02:00
|
|
|
registration: false
|
2016-07-27 23:46:48 +02:00
|
|
|
max-accounts: 3
|
2018-02-25 10:25:24 +01:00
|
|
|
|
2019-03-04 15:51:51 +01:00
|
|
|
# Whether to verify users' email addresses by sending them email with a
|
|
|
|
# verification link. If not set below, the default is not to verify in
|
|
|
|
# development, and to verify otherwise.
|
2024-10-19 13:28:53 +02:00
|
|
|
email-verification: true
|
2019-03-04 15:51:51 +01:00
|
|
|
|
2024-08-02 17:31:06 +02:00
|
|
|
# Person usernames who are allowed to create Factory actors
|
|
|
|
can-create-factories: []
|
|
|
|
|
2024-08-06 11:33:02 +02:00
|
|
|
# KeyHashids of local Factory actors who will auto-send a develop-Grant to
|
|
|
|
# every newly created account
|
|
|
|
#
|
|
|
|
# If empty or unset, and there's exactly 1 local factory in DB, it will
|
|
|
|
# automatically become the resident
|
|
|
|
resident-factories: []
|
|
|
|
|
2018-02-25 10:25:24 +01:00
|
|
|
###############################################################################
|
|
|
|
# Mail
|
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
# Optional SMTP server settings for sending email. If not provided, no email
|
|
|
|
# will be sent. The login field is optional, provide if you need SMTP
|
|
|
|
# authentication.
|
|
|
|
|
2024-10-19 13:28:53 +02:00
|
|
|
mail:
|
|
|
|
smtp:
|
|
|
|
login:
|
|
|
|
user: "_env:SMTPUSER:vervis@dev.example.org"
|
|
|
|
password: "_env:SMTPPASS:abcd0123456789"
|
|
|
|
host: "_env:SMTPHOST:smtp.example.org"
|
|
|
|
port: "_env:SMTPPORT:587"
|
|
|
|
sender:
|
|
|
|
name: "_env:SENDERNAME:Vervis"
|
|
|
|
email: "_env:SENDEREMAIL:vervis@dev.example.org"
|
|
|
|
allow-reply: false
|
2019-01-30 04:12:42 +01:00
|
|
|
|
|
|
|
###############################################################################
|
|
|
|
# Federation
|
|
|
|
###############################################################################
|
|
|
|
|
2019-03-25 01:17:24 +01:00
|
|
|
# Whether to support federation. This includes:
|
|
|
|
#
|
|
|
|
# * Accept activities from other servers in the inbox
|
|
|
|
# * Accept activities from users in the outbox
|
|
|
|
# * Deliver local activities to other servers
|
2024-10-19 13:28:53 +02:00
|
|
|
federation: true
|
2019-03-25 01:17:24 +01:00
|
|
|
|
2019-02-26 15:00:22 +01:00
|
|
|
# Whether to reject an HTTP signature when we want to insert a new key or usage
|
|
|
|
# record but reached the limit setting
|
|
|
|
reject-on-max-keys: true
|
2019-04-02 01:38:44 +02:00
|
|
|
|
|
|
|
# The duration of time during which a remote actor is unreachable and we
|
|
|
|
# periodically retry to deliver them activities. After that period of time, we
|
|
|
|
# stop trying to deliver and we remove them from follower lists of local
|
|
|
|
# actors.
|
2023-05-25 00:17:14 +02:00
|
|
|
#
|
|
|
|
# TODO this probably isn't working anymore since the switch to DeliveryTheater
|
2019-04-02 01:38:44 +02:00
|
|
|
drop-delivery-after:
|
|
|
|
amount: 25
|
|
|
|
unit: weeks
|
2019-04-18 12:38:01 +02:00
|
|
|
|
2023-05-25 00:17:14 +02:00
|
|
|
# Base of the exponential backoff for inbox POST delivery to remote actors,
|
|
|
|
# i.e. how much time to wait before the first retry. Afterwards this time
|
|
|
|
# interval will be doubled with each retry.
|
|
|
|
retry-delivery-base:
|
2024-10-19 13:28:53 +02:00
|
|
|
amount: 5
|
|
|
|
unit: minutes
|
2019-04-26 00:46:27 +02:00
|
|
|
|
|
|
|
# How many activities to remember in the debug report list, showing latest
|
|
|
|
# activities received in local inboxes and the result of their processing.
|
|
|
|
# 'null' means disable the report page entirely.
|
|
|
|
#activity-debug-reports: 10
|
2019-05-06 00:00:26 +02:00
|
|
|
|
|
|
|
# List of (hosts of) other known federating instances.
|
|
|
|
#instances: []
|
2019-05-27 20:30:48 +02:00
|
|
|
|
2024-04-13 16:00:44 +02:00
|
|
|
# Maximal length we allow for Grant chains (default: 16)
|
|
|
|
max-grant-chain-length: 16
|
|
|
|
|
2019-05-27 20:30:48 +02:00
|
|
|
###############################################################################
|
|
|
|
# User interface
|
|
|
|
###############################################################################
|
|
|
|
|
|
|
|
# Default color scheme for syntax highlighing of code blocks inside rendered
|
|
|
|
# documents. The available styles are listed in the "Text.Pandoc.Highlighting"
|
|
|
|
# module documentation.
|
|
|
|
highlight-style: zenburn
|
2022-09-28 08:03:43 +02:00
|
|
|
|
|
|
|
# Color scheme to use for UI header, footer, links on pages etc., should help
|
|
|
|
# with visually identifying instances that may otherwise look very much alike.
|
|
|
|
# Any number is valid; the scheme is chosen via modulo the number of available
|
|
|
|
# schemes.
|
|
|
|
main-color: 0
|