Add tests for extra warnings about media subdomains

config/description.exs

@@ -100,9 +100,9 @@ config :pleroma, :config_description, [
         label: "Base URL",
         type: :string,
         description:
-          "Base URL for the uploads. Required if you use a CDN or host attachments under a different domain.",
+          "Base URL for the uploads. Required if you use a CDN or host attachments under a different domain - it is HIGHLY recommended that you **do not** set this to be the same as the domain akkoma is hosted on.",
         suggestions: [
-          "https://cdn-host.com"
+          "https://media.akkoma.dev/media/"
         ]
       },
       %{

config/test.exs

@@ -22,6 +22,7 @@ config :logger, :console,
 config :pleroma, :auth, oauth_consumer_strategies: []
 
 config :pleroma, Pleroma.Upload,
+  base_url: "http://localhost:4001/media/",
   filters: [],
   link_name: false
 

docs/docs/configuration/cheatsheet.md

@@ -602,7 +602,7 @@ the source code is here: [kocaptcha](https://github.com/koto-bank/kocaptcha). Th
 * `filters`: List of [upload filters](#upload-filters) to use.
 * `link_name`: When enabled Akkoma will add a `name` parameter to the url of the upload, for example `https://instance.tld/media/corndog.png?name=corndog.png`. This is needed to provide the correct filename in Content-Disposition headers
 * `base_url`: The base URL to access a user-uploaded file; MUST be configured explicitly.
-  Using a (sub)domain distinct from the instance endpoint is **strongly** recommended.
+  Using a (sub)domain distinct from the instance endpoint is **strongly** recommended. A good value might be `https://media.myakkoma.instance/media/`. 
 * `proxy_remote`: If you're using a remote uploader, Akkoma will proxy media requests instead of redirecting to it.
 * `proxy_opts`: Proxy options, see `Pleroma.ReverseProxy` documentation.
 * `filename_display_max_length`: Set max length of a filename to display. 0 = no limit. Default: 30.

lib/pleroma/config/deprecation_warnings.ex

@@ -355,7 +355,8 @@ defmodule Pleroma.Config.DeprecationWarnings do
       \nPlease note that it is HEAVILY recommended to use a subdomain to host user-uploaded media!
       """)
 
-      :error
+      # This is a hard exit - the uploader will not work without a base_url
+      raise ArgumentError, message: "No base_url set for uploads - please set one in your config!"
     end
   end
 
@@ -369,7 +370,6 @@ defmodule Pleroma.Config.DeprecationWarnings do
     akkoma_host =
       [Pleroma.Web.Endpoint, :url]
       |> Pleroma.Config.get()
-      |> IO.inspect()
       |> Keyword.get(:host)
 
     if uploader_host == akkoma_host do

test/pleroma/config/deprecation_warnings_test.exs

@@ -289,4 +289,35 @@ defmodule Pleroma.Config.DeprecationWarningsTest do
 
     Application.put_env(:tesla, :adapter, Tesla.Mock)
   end
+
+  test "check_uploader_base_url_set/0" do
+    clear_config([Pleroma.Upload], base_url: nil)
+
+    # we need to capture the error
+    assert_raise ArgumentError, fn ->
+      assert capture_log(fn ->
+               DeprecationWarnings.check_uploader_base_url_set()
+             end) =~ "Your config does not specify a base_url for uploads!"
+    end
+
+    clear_config([Pleroma.Upload], base_url: "https://example.com")
+
+    refute capture_log(fn ->
+             DeprecationWarnings.check_uploader_base_url_set()
+           end) =~ "Your config does not specify a base_url for uploads!"
+  end
+
+  test "check_uploader_base_url_is_not_base_domain/0" do
+    clear_config([Pleroma.Upload], base_url: "http://localhost")
+
+    assert capture_log(fn ->
+             DeprecationWarnings.check_uploader_base_url_is_not_base_domain()
+           end) =~ "Your Akkoma Host and your Upload base_url's host are the same!"
+
+    clear_config([Pleroma.Upload], base_url: "https://media.localhost")
+
+    refute capture_log(fn ->
+             DeprecationWarnings.check_uploader_base_url_is_not_base_domain()
+           end) =~ "Your Akkoma Host and your Upload base_url's host are the same!"
+  end
 end