akkoma/docs/configuration/static_dir.md
Ilja e0dee833f2 Improve static_dir documentation
* It was still written for From Source installs. Now it's both OTP and From Source
* I linked to the cheatsheet where it was about configuration
* I moved the mix tasks of the robot.txt section to the CLI tasks and linked to it
    * i checked the code at https://git.pleroma.social/pleroma/pleroma/-/blob/develop/lib/mix/tasks/pleroma/robotstxt.ex and it doesn't seem to more than just this one command with this option
* I also added the location of robot.txt and an example to dissallow everything, but allow the fediverse.network crawlers
* The Thumbnail section still linked to distsn.org which doesn't exist any more. I changed it to a general statemant that it can be used by external applications. (I don't know any that actually use it.)
* Both the logo and TOS need an extra `static` folder. I've seen confusion about that in #pleroma so I added an Important note.
2020-08-08 12:21:44 +02:00

2.8 KiB

Static Directory

Static frontend files are shipped with pleroma. If you want to overwrite or update these without problems during upgrades, you can write your custom versions to the static directory.

You can find the location of the static directory in the configuration.

config :pleroma, :instance,
  static_dir: "/var/lib/pleroma/static/",
config :pleroma, :instance,
  static_dir: "instance/static/",

Alternatively, you can overwrite this value in your configuration to use a different static instance directory.

This document is written using $static_dir as the value of the config :pleroma, :instance, static_dir setting.

If you use a From Source installation and want to manage your custom files in the git repository, you can remove the instance/ entry from .gitignore.

robots.txt

There's a mix tasks to generate a new robot.txt.

For more complex things, you can write your own robots.txt to $static_dir/robots.txt.

E.g. if you want to block all crawerls except for fediverse.newtork you can use

User-Agent: *
Disallow: /

User-Agent: crawler-us-il-1.fediverse.network
Allow: /

User-Agent: makhnovtchina.random.sh
Allow: /

Thumbnail

Add $static_dir/instance/thumbnail.jpeg with your selfie or other neat picture. It will be available on http://your-domain.tld/instance/thumbnail.jpeg and can be used by external applications.

Instance-specific panel

Create and Edit your file on $static_dir/instance/panel.html.

Background

You can change the background of your Pleroma instance by uploading it to $static_dir/, and then changing background in your configuration accordingly.

E.g. if you put $static_dir/images/background.jpg

config :pleroma, :frontend_configurations,
  pleroma_fe: %{
    background: "/images/background.jpg"
  }

!!! important Note the extra static folder for the default logo.png location

If you want to give a brand to your instance, You can change the logo of your instance by uploading it to the static directory $static_dir/static/logo.png.

Alternatively, you can specify the path to your logo in your configuration.

E.g. if you put $static_dir/static/mylogo-file.png

config :pleroma, :frontend_configurations,
  pleroma_fe: %{
   logo: "/static/mylogo-file.png"
  }

Terms of Service

!!! important Note the extra static folder for the terms-of-service.html

Terms of Service will be shown to all users on the registration page. It's the best place where to write down the rules for your instance. You can modify the rules by adding and changing $static_dir/static/terms-of-service.html.