use doku::Document; use serde::{Deserialize, Serialize}; use std::net::{IpAddr, Ipv4Addr}; use url::Url; #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)] #[serde(default)] pub struct Settings { /// settings related to the postgresql database #[default(Default::default())] pub database: DatabaseConfig, /// Settings related to activitypub federation /// Pictrs image server configuration. #[default(Some(Default::default()))] pub(crate) pictrs: Option, /// Email sending configuration. All options except login/password are mandatory #[default(None)] #[doku(example = "Some(Default::default())")] pub email: Option, /// Parameters for automatic configuration of new instance (only used at first start) #[default(None)] #[doku(example = "Some(Default::default())")] pub setup: Option, /// the domain name of your instance (mandatory) #[default("unset")] #[doku(example = "example.com")] pub hostname: String, /// Address where lemmy should listen for incoming requests #[default(IpAddr::V4(Ipv4Addr::new(0, 0, 0, 0)))] #[doku(as = "String")] pub bind: IpAddr, /// Port where lemmy should listen for incoming requests #[default(8536)] pub port: u16, /// Whether the site is available over TLS. Needs to be true for federation to work. #[default(true)] pub tls_enabled: bool, /// Set the URL for opentelemetry exports. If you do not have an opentelemetry collector, do not set this option #[default(None)] #[doku(skip)] pub opentelemetry_url: Option, } #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)] #[serde(default, deny_unknown_fields)] pub struct PictrsConfig { /// Address where pictrs is available (for image hosting) #[default(Url::parse("http://localhost:8080").expect("parse pictrs url"))] #[doku(example = "http://localhost:8080")] pub url: Url, /// Set a custom pictrs API key. ( Required for deleting images ) #[default(None)] pub api_key: Option, } #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)] #[serde(default)] pub struct DatabaseConfig { #[serde(flatten, default)] pub connection: DatabaseConnection, /// Maximum number of active sql connections #[default(5)] pub pool_size: usize, } #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)] #[serde(untagged)] pub enum DatabaseConnection { /// Configure the database by specifying a URI /// /// This is the preferred method to specify database connection details since /// it is the most flexible. Uri { /// Connection URI pointing to a postgres instance /// /// This example uses peer authentication to obviate the need for creating, /// configuring, and managing passwords. /// /// For an explanation of how to use connection URIs, see [here][0] in /// PostgreSQL's documentation. /// /// [0]: https://www.postgresql.org/docs/current/libpq-connect.html#id-1.7.3.8.3.6 #[doku(example = "postgresql:///lemmy?user=lemmy&host=/var/run/postgresql")] uri: String, }, /// Configure the database by specifying parts of a URI /// /// Note that specifying the `uri` field should be preferred since it provides /// greater control over how the connection is made. This merely exists for /// backwards-compatibility. #[default] Parts(DatabaseConnectionParts), } #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)] #[serde(default)] pub struct DatabaseConnectionParts { /// Username to connect to postgres #[default("lemmy")] pub(super) user: String, /// Password to connect to postgres #[default("password")] pub password: String, #[default("localhost")] /// Host where postgres is running pub host: String, /// Port where postgres can be accessed #[default(5432)] pub(super) port: i32, /// Name of the postgres database for lemmy #[default("lemmy")] pub(super) database: String, } #[derive(Debug, Deserialize, Serialize, Clone, Document, SmartDefault)] #[serde(deny_unknown_fields)] pub struct EmailConfig { /// Hostname and port of the smtp server #[doku(example = "localhost:25")] pub smtp_server: String, /// Login name for smtp server pub smtp_login: Option, /// Password to login to the smtp server pub smtp_password: Option, #[doku(example = "noreply@example.com")] /// Address to send emails from, eg "noreply@your-instance.com" pub smtp_from_address: String, /// Whether or not smtp connections should use tls. Can be none, tls, or starttls #[default("none")] #[doku(example = "none")] pub tls_type: String, } #[derive(Debug, Deserialize, Serialize, Clone, SmartDefault, Document)] #[serde(deny_unknown_fields)] pub struct SetupConfig { /// Username for the admin user #[doku(example = "admin")] pub admin_username: String, /// Password for the admin user. It must be at least 10 characters. #[doku(example = "tf6HHDS4RolWfFhk4Rq9")] pub admin_password: String, /// Name of the site (can be changed later) #[doku(example = "My Lemmy Instance")] pub site_name: String, /// Email for the admin user (optional, can be omitted and set later through the website) #[doku(example = "user@example.com")] #[default(None)] pub admin_email: Option, }