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_migrations_applied!()
20 |> check_welcome_message_config!()
25 defp handle_result(:ok), do: :ok
26 defp handle_result({:error, message}), do: raise(VerifyError, message: message)
28 defp check_welcome_message_config!(:ok) do
29 if Pleroma.Config.get([:welcome, :email, :enabled], false) and
30 not Pleroma.Emails.Mailer.enabled?() do
32 To send welcome email do you need to enable mail.
33 \nconfig :pleroma, Pleroma.Emails.Mailer, enabled: true
36 {:error, "The mail disabled."}
42 defp check_welcome_message_config!(result), do: result
44 # Checks for pending migrations.
46 def check_migrations_applied!(:ok) do
47 unless Pleroma.Config.get(
48 [:i_am_aware_this_may_cause_data_loss, :disable_migration_check],
52 Ecto.Migrator.with_repo(Pleroma.Repo, fn repo ->
54 Ecto.Migrator.migrations(repo)
57 {:down, _, _} -> false
60 if length(down_migrations) > 0 do
61 down_migrations_text =
62 Enum.map(down_migrations, fn {:down, id, name} -> "- #{name} (#{id})\n" end)
65 "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"
68 {:error, "Unapplied Migrations detected"}
80 def check_migrations_applied!(result), do: result
82 # Checks for settings of RUM indexes.
84 defp check_rum!(:ok) do
86 Ecto.Migrator.with_repo(Pleroma.Repo, fn repo ->
89 where: o.table_name == "objects",
90 where: o.column_name == "fts_content"
92 |> repo.exists?(prefix: "information_schema")
94 setting = Pleroma.Config.get([:database, :rum_enabled], false)
96 do_check_rum!(setting, migrate)
102 defp check_rum!(result), do: result
104 defp do_check_rum!(setting, migrate) do
105 case {setting, migrate} do
108 "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/`"
111 {:error, "Unapplied RUM Migrations detected"}
115 "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/`"
118 {:error, "RUM Migrations detected"}