Custom Server Logo
Set a custom image for the top of a server’s detail page. This is separate from Mark URL, which sets the small mark shown beside a server’s name in lists.
Per-server setting
Section titled “Per-server setting”- Open the server’s edit page and expand Optional → Appearance & location.
- Enter the image URL in Logo URL and save the server.
The per-server Logo URL takes precedence over the global setting. Both URLs support the formatting placeholders below.
Global default
Section titled “Global default”Open Settings → Server → General → Distribution mark → Logo URL to set the default image URL for servers without their own Logo URL.
URL placeholders
Section titled “URL placeholders”{DIST}: Linux distribution
Section titled “{DIST}: Linux distribution”{DIST} is replaced with the Linux distribution name detected by the App:
https://example.com/{DIST}.pngFor example, the resulting URL may end in debian.png, ubuntu.png, or
arch.png. If the App cannot detect the distribution, it does not use the
Logo URL.
{BRIGHT}: Theme
Section titled “{BRIGHT}: Theme”{BRIGHT} is replaced according to the current theme:
https://example.com/{BRIGHT}.pngThe selected Logo URL resolves to light.png in a light theme and dark.png
in a dark theme.
Combining both
Section titled “Combining both”https://example.com/{DIST}-{BRIGHT}.pngFor example, the App may request debian-light.png or ubuntu-dark.png,
depending on the detected distribution and current theme.
Recommendations
Section titled “Recommendations”- Use a PNG or SVG image between 64×64 and 128×128 pixels.
- Prefer an HTTPS URL.
- Keep the image small so loading it does not slow down the server card.
Supported distributions
Section titled “Supported distributions”debian, ubuntu, centos, fedora, opensuse, kali, alpine, arch, rocky, deepin, armbian, wrt, coreelec
See dist.dart for the complete list.