1 # Pleroma: A lightweight social networking server
2 # Copyright © 2017-2020 Pleroma Authors <https://pleroma.social/>
3 # SPDX-License-Identifier: AGPL-3.0-only
5 defmodule Pleroma.ApplicationRequirements do
7 The module represents the collection of validations to runs before start server.
10 defmodule VerifyError, do: defexception([:message])
16 @spec verify!() :: :ok | VerifyError.t()
19 |> check_confirmation_accounts!
20 |> check_migrations_applied!()
21 |> check_welcome_message_config!()
26 defp handle_result(:ok), do: :ok
27 defp handle_result({:error, message}), do: raise(VerifyError, message: message)
29 defp check_welcome_message_config!(:ok) do
30 if Pleroma.Config.get([:welcome, :email, :enabled], false) and
31 not Pleroma.Emails.Mailer.enabled?() do
33 To send welcome email do you need to enable mail.
34 \nconfig :pleroma, Pleroma.Emails.Mailer, enabled: true
37 {:error, "The mail disabled."}
43 defp check_welcome_message_config!(result), do: result
45 # Checks account confirmation email
47 def check_confirmation_accounts!(:ok) do
48 if Pleroma.Config.get([:instance, :account_activation_required]) &&
49 not Pleroma.Config.get([Pleroma.Emails.Mailer, :enabled]) do
51 "Account activation enabled, but no Mailer settings enabled.\nPlease set config :pleroma, :instance, account_activation_required: false\nOtherwise setup and enable Mailer."
55 "Account activation enabled, but Mailer is disabled. Cannot send confirmation emails."}
61 def check_confirmation_accounts!(result), do: result
63 # Checks for pending migrations.
65 def check_migrations_applied!(:ok) do
66 unless Pleroma.Config.get(
67 [:i_am_aware_this_may_cause_data_loss, :disable_migration_check],
71 Ecto.Migrator.with_repo(Pleroma.Repo, fn repo ->
73 Ecto.Migrator.migrations(repo)
76 {:down, _, _} -> false
79 if length(down_migrations) > 0 do
80 down_migrations_text =
81 Enum.map(down_migrations, fn {:down, id, name} -> "- #{name} (#{id})\n" end)
84 "The following migrations were not applied:\n#{down_migrations_text}If you want to start Pleroma anyway, set\nconfig :pleroma, :i_am_aware_this_may_cause_data_loss, disable_migration_check: true"
87 {:error, "Unapplied Migrations detected"}
99 def check_migrations_applied!(result), do: result
101 # Checks for settings of RUM indexes.
103 defp check_rum!(:ok) do
105 Ecto.Migrator.with_repo(Pleroma.Repo, fn repo ->
108 where: o.table_name == "objects",
109 where: o.column_name == "fts_content"
111 |> repo.exists?(prefix: "information_schema")
113 setting = Pleroma.Config.get([:database, :rum_enabled], false)
115 do_check_rum!(setting, migrate)
121 defp check_rum!(result), do: result
123 defp do_check_rum!(setting, migrate) do
124 case {setting, migrate} do
127 "Use `RUM` index is enabled, but were not applied migrations for it.\nIf you want to start Pleroma anyway, set\nconfig :pleroma, :database, rum_enabled: false\nOtherwise apply the following migrations:\n`mix ecto.migrate --migrations-path priv/repo/optional_migrations/rum_indexing/`"
130 {:error, "Unapplied RUM Migrations detected"}
134 "Detected applied migrations to use `RUM` index, but `RUM` isn't enable in settings.\nIf you want to use `RUM`, set\nconfig :pleroma, :database, rum_enabled: true\nOtherwise roll `RUM` migrations back.\n`mix ecto.rollback --migrations-path priv/repo/optional_migrations/rum_indexing/`"
137 {:error, "RUM Migrations detected"}