2 use serde::{Deserialize, Serialize};
3 use std::net::{IpAddr, Ipv4Addr};
5 #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)]
8 /// settings related to the postgresql database
10 pub database: DatabaseConfig,
11 #[default(Some(RateLimitConfig::default()))]
12 /// rate limits for various user actions, by user ip
13 pub rate_limit: Option<RateLimitConfig>,
14 /// Settings related to activitypub federation
15 #[default(FederationConfig::default())]
16 pub federation: FederationConfig,
17 #[default(CaptchaConfig::default())]
18 pub captcha: CaptchaConfig,
19 /// Email sending configuration. All options except login/password are mandatory
21 pub email: Option<EmailConfig>,
22 /// Parameters for automatic configuration of new instance (only used at first start)
24 pub setup: Option<SetupConfig>,
25 /// the domain name of your instance (mandatory)
27 #[doku(example = "example.com")]
29 /// Address where lemmy should listen for incoming requests
30 #[default(IpAddr::V4(Ipv4Addr::new(0, 0, 0, 0)))]
31 #[doku(as = "String")]
33 /// Port where lemmy should listen for incoming requests
36 /// Whether the site is available over TLS. Needs to be true for federation to work.
38 pub tls_enabled: bool,
39 /// Address where pictrs is available (for image hosting)
41 #[doku(example = "http://localhost:8080")]
42 pub pictrs_url: Option<String>,
44 #[doku(example = "(\\bThis\\b)|(\\bis\\b)|(\\bsample\\b)")]
45 pub slur_filter: Option<String>,
46 /// Maximum length of local community and user names
48 pub actor_name_max_length: usize,
49 /// Maximum number of HTTP requests allowed to handle a single incoming activity (or a single object fetch through the search).
51 pub http_fetch_retry_limit: i32,
54 #[doku(example = "http://localhost:4317")]
55 pub opentelemetry_url: Option<String>,
58 #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)]
60 pub struct CaptchaConfig {
61 /// Whether captcha is required for signup
64 /// Can be easy, medium, or hard
66 pub difficulty: String,
69 #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)]
71 pub struct DatabaseConfig {
72 /// Username to connect to postgres
74 pub(super) user: String,
75 /// Password to connect to postgres
76 #[default("password")]
78 #[default("localhost")]
79 /// Host where postgres is running
81 /// Port where postgres can be accessed
84 /// Name of the postgres database for lemmy
86 pub(super) database: String,
87 /// Maximum number of active sql connections
92 #[derive(Debug, Deserialize, Serialize, Clone, Document, SmartDefault)]
93 pub struct EmailConfig {
94 /// Hostname and port of the smtp server
95 #[doku(example = "localhost:25")]
96 pub smtp_server: String,
97 /// Login name for smtp server
98 pub smtp_login: Option<String>,
99 /// Password to login to the smtp server
100 pub smtp_password: Option<String>,
101 #[doku(example = "noreply@example.com")]
102 /// Address to send emails from, eg "noreply@your-instance.com"
103 pub smtp_from_address: String,
104 /// Whether or not smtp connections should use tls. Can be none, tls, or starttls
106 #[doku(example = "none")]
107 pub tls_type: String,
110 #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)]
112 pub struct FederationConfig {
113 /// Whether to enable activitypub federation.
116 /// Allows and blocks are described here:
117 /// https://join-lemmy.org/docs/en/federation/administration.html///instance-allowlist-and-blocklist
119 /// list of instances with which federation is allowed
121 #[doku(example = "instance1.tld")]
122 #[doku(example = "instance2.tld")]
123 pub allowed_instances: Option<Vec<String>>,
124 /// Instances which we never federate anything with (but previously federated objects are unaffected)
126 pub blocked_instances: Option<Vec<String>>,
127 /// If true, only federate with instances on the allowlist and block everything else. If false,
128 /// use allowlist only for remote communities, and posts/comments in local communities
129 /// (meaning remote communities will show content from arbitrary instances).
131 pub strict_allowlist: bool,
134 #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)]
136 pub struct RateLimitConfig {
137 /// Maximum number of messages created in interval
140 /// Interval length for message limit, in seconds
142 pub message_per_second: i32,
143 /// Maximum number of posts created in interval
146 /// Interval length for post limit, in seconds
148 pub post_per_second: i32,
149 /// Maximum number of registrations in interval
152 /// Interval length for registration limit, in seconds
154 pub register_per_second: i32,
155 /// Maximum number of image uploads in interval
158 /// Interval length for image uploads, in seconds
160 pub image_per_second: i32,
161 /// Maximum number of comments created in interval
164 /// Interval length for comment limit, in seconds
166 pub comment_per_second: i32,
169 #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)]
170 pub struct SetupConfig {
171 /// Username for the admin user
172 #[doku(example = "admin")]
173 pub admin_username: String,
174 /// Password for the admin user. It must be at least 10 characters.
175 #[doku(example = "my_passwd_longer_than_ten_characters")]
176 pub admin_password: String,
177 /// Name of the site (can be changed later)
178 #[doku(example = "My Lemmy Instance")]
179 pub site_name: String,
180 /// Email for the admin user (optional, can be omitted and set later through the website)
182 pub admin_email: Option<String>,
184 pub sidebar: Option<String>,
186 pub description: Option<String>,
188 pub icon: Option<String>,
190 pub banner: Option<String>,
192 pub enable_downvotes: Option<bool>,
194 pub open_registration: Option<bool>,
196 pub enable_nsfw: Option<bool>,
198 pub community_creation_admin_only: Option<bool>,
200 pub require_email_verification: Option<bool>,
202 pub require_application: Option<bool>,
204 pub application_question: Option<String>,
206 pub private_instance: Option<bool>,