For the complete documentation index, see llms.txt. This page is also available as Markdown.

HTTPS

Make screenshots and videos load in the panel. Pick one of three ways.

The panel runs on HTTPS, so browsers only show files that also come over HTTPS. Without it the Media page shows Needs HTTPS on the game server, and uploads and ZIP downloads stop. Screenshots inside the game work either way.

Which way?

You have
Use
What to do

Only the server's IP

Automatic certificate (the default)

Open TCP port 80, nothing else

A domain

The easiest way: free, no ports to open

Your own certificate or nginx

custom or off

See the last two sections below

Automatic certificate

This is the default (tgiann_media_https "auto"). The service gets a free Let's Encrypt certificate for your server's IP and renews it on its own.

  1. Open TCP 80 and the media port, see Ports and Firewall.

  2. Restart the resource.

  3. The console shows https: certificate active for <ip>. Done.

If the console shows Let's Encrypt could not reach TCP port 80, port 80 is still closed somewhere (your host's panel or DDoS filter). The service tries again every hour; restart the resource to try at once.

The server has several IPs and the wrong one is used? Set it: set tgiann_media_public_ip "203.0.113.10".

Your own certificate (custom)

set tgiann_media_https "custom"
set tgiann_media_tls_cert "C:/certs/fullchain.pem"
set tgiann_media_tls_key "C:/certs/privkey.pem"

The files are read again every 6 hours, so a renewed certificate is picked up without a restart. Then enter the address the certificate is for in Settings > Media storage > Public address, for example https://media.yourserver.com:6174.

Your own proxy (off)

For nginx, Caddy or another proxy in front of the service:

Point the proxy at http://127.0.0.1:6174 and allow uploads up to 400 MB:

Then enter https://media.yourserver.com in Settings > Media storage > Public address.

Check it

Open http://<server-ip>:6174/health. The https part shows "state":"active" when it works, or "error" with the reason.

Test server on a home PC? Use set tgiann_media_https "off". Behind a home router the automatic certificate cannot work and would break pictures in your own game.