Headless server software/ARM

The Headless Server Software is supported on ARM64-based Linux machines, such as the Oracle Cloud free tier.

Steps

Pre-requisites

Several pre-requisites are needed to run the Headless:

• .NET 10 Runtime
• Either SteamCMD or DepotDownloader to Download the headless, you can also copy the headless from your Resonite install if you're on the headless branch
  • SteamCMD is not officially supported on ARM but can be used through box64 built with the box32 flag

Downloading the Headless Server Software

SteamCMD

Downloading the Headless Server Software through SteamCMD is done as following:

steamcmd +force_install_dir /path/to/install \
  +login YOUR_STEAM_USERNAME YOUR_STEAM_PASSWORD \
  +app_update 2519830 -beta headless -betapassword HEADLESS_BETA_CODE validate \
  +quit

DepotDownloader

Downloading the Headless Server Software through DepotDownloader is done as following:

DepotDownloader -app 2519830 \
  -username YOUR_STEAM_USERNAME -password YOUR_STEAM_PASSWORD \
  -branch headless -branchpassword HEADLESS_BETA_CODE \
  -dir /path/to/install

DepotDownloader does not set executable permissions on the files it downloads. To avoid some issues (in particular regarding external tools such as yt-dlp) you should also run chmod -R +x /path/to/install

Modding

Linux aarch64 support for MonoMod has now been merged, so all your mods should work as expected!

Troubleshooting

If you are having any issues, please ask in the Resonite Discord, in the "Headless on ARM" thread (requires account).

Acknowledgements

Several people made running Resonite on ARM-based machines possible:

• Orion Moonclaw for helping and testing native libraries, janky arm64 MonoMod branch
• WattleFoxxo for compiling the information and writing the original version of this guide on Discord
• J4 for providing build processes and pre-compiled native libraries