akkoma/docs/docs/configuration/storing_remote_media.md
ilja 3947012691 Fix warnings
There were two warnings, these are now fixed.

I moved the fonts folder into the css folder. Antother option was to change the relative path,
but it seems that after changing it in the css file, the path got changed back when rebuilding the site.
Maybe it needs to be changed somewhere else, idk, this worked.
2023-05-29 09:10:07 +02:00

1.8 KiB

Storing Remote Media

Akkoma does not store remote/federated media by default. The best way to achieve this is to change Nginx to keep its reverse proxy cache for a year and to activate the MediaProxyWarmingPolicy MRF policy in Akkoma which will automatically fetch all media through the proxy as soon as the post is received by your instance.

Nginx

The following are excerpts from the suggested nginx config that demonstrates the necessary config for the media proxy to work.

A proxy_cache_path must be defined, for example:

proxy_cache_path /long/term/storage/path/akkoma-media-cache levels=1:2
    keys_zone=akkoma_media_cache:10m inactive=1y use_temp_path=off;

The proxy_cache_path must then be configured for use with media proxy paths:

    location ~ ^/(media|proxy) {
        proxy_cache        akkoma_media_cache;
        slice              1m;
        proxy_cache_key    $host$uri$is_args$args$slice_range;
        proxy_set_header   Range $slice_range;
        proxy_cache_valid  200 206 301 304 1h;
        proxy_cache_lock   on;
        proxy_ignore_client_abort on;
        proxy_buffering    on;
        chunked_transfer_encoding on;
        proxy_pass         http://phoenix;
    }
}

Ensure that proxy_http_version 1.1; is set for the above location block. In the suggested config, this is already the case.

Akkoma

File-based Configuration

If you're using static file configuration, add the MediaProxyWarmingPolicy to your MRF policies. For example:

config :pleroma, :mrf,
  policies: [Pleroma.Web.ActivityPub.MRF.MediaProxyWarmingPolicy]

Database Configuration

In the admin interface, add MediaProxyWarmingPolicy to the Policies option under SettingsMRF.