Skip to main content

Rust server setup

How to add a header image to your Rust server

The header image is the banner at the top of your server page, and it is the only visual you get in a list that is otherwise all text. Rust is strict about it: exactly 512 by 256 pixels, PNG, publicly reachable.

  • Rust guides
  • Updated
  • 6 min read
  • Exactly 512x256
  • PNG only
  • Direct URL required
REQUIREMENTSDimensions512 x 256Format.pngHostingPublicURLDirect to fileConvarserver.headerimageThe dimensions are exact, not a maximum. Anything else displays wrong or not at all.

The short answer

Make a PNG that is exactly 512 by 256 pixels, host it somewhere publicly reachable, then add server.headerimage "https://yourhost.com/yourimage.png" to server.cfg and restart.

Key points

  • 512 x 256 exactly. Not larger, not a different ratio.
  • PNG only.
  • The URL must return the image file, not a page about it.
  • No login, no authentication, no private links.
  • Restart the server for the change to appear.

The requirements

A header image gives players a quick visual impression of what your server is about, which matters in a list that is otherwise a wall of text. Rust is unusually strict about the file.

Publicly accessible
Hosted on a website anyone can reach. The URL must be direct and must not sit behind any form of authentication or login.
Exactly 512 x 256 pixels
This is the size, not a limit. Anything else will display distorted or fail to load.
PNG format
Good quality at a reasonable file size, and the format the game expects.

We offer free image hosting to customers. If you would rather not find somewhere to put the file yourself, open a support ticket and ask.

Hosting the image

The most common reason a header image never appears is the hosting rather than the image. Your server is not a browser: it makes a request and expects an image back.

Many file sharing services, given their normal share link, return a web page with a preview and a download button. That page is what your server receives, and since it is not a PNG, nothing displays.

Test before you configure. Paste your URL into a private browser window. If the raw image fills the window, your server will get the same thing. If you see a page with a download button, it will not.

Adding it to your server

  1. Log in to the control panel

    Access the control panel with your credentials.

  2. Open Game Services

    Click the Game Services tab. This lists all the game servers on your account.

    The Game Services menu item in the control panel
    Game Services
  3. Select your Rust service

    Find your Rust server in the list and click it.

    The Rust service in the control panel service list
    Rust Service
  4. Stop the server

    Click Stop before making changes. Editing config on a running server means your edit is overwritten when it shuts down.

    The Stop button on the Rust server management page
    Stop Server
  5. Open Configuration Files

    Go to the Configuration Files section.

    The Configuration Files section of the control panel
    Configuration Files
  6. Edit server.cfg

    Open server.cfg with the text editor. Take a backup first if you have anything in there you would not want to retype.

    The server.cfg file open in the control panel text editor
    Edit server.cfg
  7. Add your header image

    Add this line, with your own URL in place of the example:

    server.headerimage "https://files.eugamehost.com/storage/uploads/eugamehost-rust.png"

    Make sure the URL points directly at the image file and ends in .png.

  8. Save and restart

    Click Save and Exit, then start the server. The image appears once it is back up.

    The Start button on the Rust server management page
    Start Server

Designing one that works

512 by 256 is a wide, short banner, and it is usually seen small. A design that looks good at full size can be unreadable where it actually appears.

Keep text large and short
Server name and maybe one line. Anything smaller than that will not survive being scaled down.
High contrast
Dark text on a busy screenshot disappears. Use a solid block behind any text you need people to read.
Say what the server is
Wipe schedule, rates, or the one thing that makes it different. A logo alone tells a player nothing useful.
Leave the edges alone
Do not put anything critical right against the border, in case of cropping.
Check it at small size
Scale your design down to a quarter and look again. That is closer to how it will be seen.

When it does not show

Wrong dimensions
Check the file is exactly 512 x 256. Close is not close enough.
Not a PNG
A JPG renamed to .png is still a JPG. Re-export it properly.
URL returns a page
Test in a private browser window. If you see anything other than the raw image, so will the server.
Host requires a login
Private links and authenticated hosts will refuse your server exactly as they would refuse a stranger.
Server not restarted
The config is read at startup. Until it restarts, nothing changes.
Host went down
An image on an unreliable host disappears from your listing whenever that host has a bad day. Use somewhere dependable.

A header image is one of three things that make up your listing. The others are your description and your tags, and all three are worth getting right before you start advertising.

More guides for people running their own Rust server.

Quick answers

Common questions

Exactly 512 by 256 pixels. It is not a maximum or a recommendation, it is the size the game expects, and anything else will display distorted or not at all.

PNG. The file must be a .png, and the URL you give the server must point directly at that file rather than at a page containing it.

Add server.headerimage "https://yourhost.com/yourimage.png" to server.cfg, save, and restart the server. The URL must be publicly reachable without a login.

The usual causes are the wrong dimensions, a format other than PNG, a URL that needs authentication, or a link to a share page rather than to the image file itself. Test the URL in a private browser window: if you see the raw image, the server will too.

Anywhere that serves the file publicly over a direct link. We offer free image hosting to customers, so open a support ticket if you want us to host it. Avoid anything that requires a login or serves a preview page.

Yes. The setting is read from the config at startup, so the change appears once the server has restarted.

Rust hosting with free image hosting

Config file access on every Rust server we host, and we will host your header image for you. Open a ticket and ask.

  • UK data centre
  • Free image hosting
  • Support by ticket and Discord