Find your Stardew Valley SMAPI log on Steam Deck in ~/.config/StardewValley/ErrorLogs when you run the native Linux game. If SMAPI stopped opening after an update, clear Steam's Launch Options and rerun the Linux installer. These steps apply to SMAPI 4.5.2, released on 14 March 2026 for Stardew Valley 1.6.14 or later.

Find your Steam Deck SMAPI log

Switch to Desktop Mode and open the file manager. Use its location bar to go to ~/.config/StardewValley/ErrorLogs. Pick SMAPI-crash.txt when it exists, otherwise pick SMAPI-latest.txt. Open the log parser at smapi.io/log, choose the file and submit it. Check the game version, SMAPI version and game folder in the parsed log before you change anything. That gives you the installation to work on.

For a mod that was skipped, read the error beside its name. If it names a missing dependency, install that dependency using the mod author's instructions. If it flags an incompatible version, update the named mod and check the log again after launching. When the game opens without SMAPI, check which game build Steam starts and repair the loader before working through individual mods.

Check whether Steam runs Linux or Proton

Select Stardew Valley in your Steam library, scroll to GAME INFO and look under Steam Deck Compatibility. Steam Linux Runtime means you are running the native game. Proton followed by a version number means you are running the Windows game. Use the Linux installer steps below for Steam Linux Runtime. For Proton, follow the manual Windows instructions in the SMAPI download's README.txt and the Steam configuration steps in the Deck installation instructions.

Back up your saves and Mods folder before changing the runtime. Keep a copy of your previous Steam settings so you can restore them. Modded saves under Proton need local backups because cloud sync is unavailable for them. If you chose Proton to investigate a missing Stardew Valley invite code, treat that multiplayer problem separately from getting the loader to run.

Clear Launch Options for the native game

To return to native mode, open Properties > Compatibility and clear the forced Proton selection. Let Steam finish any download, then confirm Steam Linux Runtime under GAME INFO. Open Properties > General and copy any existing Launch Options to a note before clearing the box. Leave it empty for native Stardew so Steam can use the Linux launcher installed by SMAPI.

Reinstall the Linux launcher

In Desktop Mode, download SMAPI from smapi.io and extract the ZIP outside the game folder. In the extracted directory, use the file manager to make install on Linux.sh and internal/linux/SMAPI.Installer executable. Run install on Linux.sh and follow the prompts. If it asks for the game folder, use Steam's installed-files browser to find the copy you actually launch, including one stored on removable storage.

Choose Install, then start Stardew Valley from your Steam library. Check that SMAPI starts alongside the game, then check the log for the mods you expect to load. If the game still fails to start, open a terminal in the game folder and run ./StardewModdingAPI. A missing libhostpolicy.so error points to Linux SMAPI paired with the Proton game. Return to GAME INFO and match the loader to the selected runtime.

A farmer and chickens beside planted crops on an autumn Stardew Valley farm
An official unmodded Stardew Valley press image. Reaching the game is separate from confirming SMAPI and each mod have loaded. · ConcernedApe

Check the unmodded game

Launch StardewValley-original from the native game folder and see whether it reaches the title screen. Stop there to keep your modded farm out of the check. If you choose to remove SMAPI, run the Linux installer again and choose Uninstall. Keep Launch Options empty and preserve your saves and mod backups while you check whether the base game starts.

Sources

Where this story comes from, and where you can check it.

Official sources

  1. SMAPI / PathoschildSMAPI download and current requirements ↗
  2. SMAPI player documentationInstalling SMAPI on Steam Deck ↗
  3. SMAPI player documentationInstalling SMAPI on Linux ↗
  4. SMAPI player documentationPlayer Guide: Troubleshooting ↗
  5. SMAPI / PathoschildSMAPI log parser: Linux log location and error information ↗
  6. SMAPI player documentationPlayer Guide: Getting Started - finding the game folder ↗
  7. Steam SupportSteam Deck: Software Info and Troubleshooting Guide ↗
  8. SMAPI / Pathoschild4.5.2 ↗

Independent reporting

  1. PC GamerStardew Valley's 1.6 update is finally live, and Eric Barone wasn't kidding: it is massive ↗