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

18 lines
906 B
Markdown
Raw Permalink Normal View History

2023-03-06 06:47:34 +05:30
## 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 {
2023-03-06 06:47:34 +05:30
let config = FederationConfig::builder()
.domain("example.com")
.app_data(db_connection)
.build().await?;
2023-03-06 06:47:34 +05:30
# Ok::<(), anyhow::Error>(())
# }).unwrap()
2023-03-06 06:47:34 +05:30
```
`debug` is necessary to test federation with http and localhost URLs, but it should never be used in production. `url_verifier` can be used to implement a domain blacklist.