74d3333420b9683a1f3127d1f9917669ee031364
[akkoma] / docs / administration / storing_remote_media.md
1 # Storing Remote Media
2
3 Pleroma does not store remote/federated media by default. The best way to achieve this is to change Nginx to keep its reverse proxy cache
4 forever and to activate the `MediaProxyWarmingPolicy` MRF policy in Pleroma which will automatically fetch all media through the proxy
5 as soon as the post is received by your instance.
6
7 ## Nginx
8
9 ```
10 proxy_cache_path /long/term/storage/path/pleroma-media-cache levels=1:2
11 keys_zone=pleroma_media_cache:10m inactive=1y use_temp_path=off;
12
13 location ~ ^/(media|proxy) {
14 proxy_cache pleroma_media_cache;
15 slice 1m;
16 proxy_cache_key $host$uri$is_args$args$slice_range;
17 proxy_set_header Range $slice_range;
18 proxy_http_version 1.1;
19 proxy_cache_valid 206 301 302 304 1h;
20 proxy_cache_valid 200 1y;
21 proxy_cache_lock on;
22 proxy_cache_use_stale error timeout invalid_header updating;
23 proxy_ignore_client_abort on;
24 proxy_buffering on;
25 chunked_transfer_encoding on;
26 proxy_ignore_headers Cache-Control Expires;
27 proxy_hide_header Cache-Control Expires;
28 proxy_pass http://127.0.0.1:4000;
29 }
30 ```
31
32 ## Pleroma
33
34 Add to your `prod.secret.exs`:
35
36 ```
37 config :pleroma, :instance,
38 rewrite_policy: [Pleroma.Web.ActivityPub.MRF.MediaProxyWarmingPolicy]
39 ```