activitypub-federation-rust/docs/05_configuration.md

## Configuration

Next we need to do some configuration. Most importantly we need to specify the domain where the federated instance is running. It should be at the domain root and available over HTTPS for production. See the documentation for a list of config options. The parameter `user_data` is for anything that your application requires in handler functions, such as database connection handle, configuration etc.

```
# use activitypub_federation::config::FederationConfig;
# let db_connection = ();
# tokio::runtime::Runtime::new().unwrap().block_on(async {
let config = FederationConfig::builder()
    .domain("example.com")
    .app_data(db_connection)
    .build().await?;
# Ok::<(), anyhow::Error>(())
# }).unwrap()
```

`debug` is necessary to test federation with http and localhost URLs, but it should never be used in production. The `worker_count` value can be adjusted depending on the instance size. A lower value saves resources on a small instance, while a higher value is necessary on larger instances to keep up with send jobs. `url_verifier` can be used to implement a domain blacklist.
move files 2023-03-06 01:17:34 +00:00			`## Configuration`

			Next we need to do some configuration. Most importantly we need to specify the domain where the federated instance is running. It should be at the domain root and available over HTTPS for production. See the documentation for a list of config options. The parameter `user_data` is for anything that your application requires in handler functions, such as database connection handle, configuration etc.

			```
			`# use activitypub_federation::config::FederationConfig;`
			`# let db_connection = ();`
Remove `actix-rt` and replace with tokio tasks (#42) * Remove `actix-rt` and replace with tokio tasks * Include activity queue test * Use older `Arc` method * Refactor to not re-process PEM data on each request * Add retry queue and spawn tokio tasks directly * Fix doc error * Remove semaphore and use join set for backpressure * Fix debug issue with multiple mailboxes 2023-06-20 09:54:14 +00:00			`# tokio::runtime::Runtime::new().unwrap().block_on(async {`
move files 2023-03-06 01:17:34 +00:00			`let config = FederationConfig::builder()`
			`.domain("example.com")`
			`.app_data(db_connection)`
Remove `actix-rt` and replace with tokio tasks (#42) * Remove `actix-rt` and replace with tokio tasks * Include activity queue test * Use older `Arc` method * Refactor to not re-process PEM data on each request * Add retry queue and spawn tokio tasks directly * Fix doc error * Remove semaphore and use join set for backpressure * Fix debug issue with multiple mailboxes 2023-06-20 09:54:14 +00:00			`.build().await?;`
move files 2023-03-06 01:17:34 +00:00			`# Ok::<(), anyhow::Error>(())`
Remove `actix-rt` and replace with tokio tasks (#42) * Remove `actix-rt` and replace with tokio tasks * Include activity queue test * Use older `Arc` method * Refactor to not re-process PEM data on each request * Add retry queue and spawn tokio tasks directly * Fix doc error * Remove semaphore and use join set for backpressure * Fix debug issue with multiple mailboxes 2023-06-20 09:54:14 +00:00			`# }).unwrap()`
move files 2023-03-06 01:17:34 +00:00			```

			`debug` is necessary to test federation with http and localhost URLs, but it should never be used in production. The `worker_count` value can be adjusted depending on the instance size. A lower value saves resources on a small instance, while a higher value is necessary on larger instances to keep up with send jobs. `url_verifier` can be used to implement a domain blacklist.