Stardew Valley Wiki

Modding:Installing SMAPI on Linux

Revision as of 23:54, 25 December 2022 by Celeste (talk | contribs) (Added instructions for Arch Linux installation, and updated instructions for Ubuntu)
← Modding:Index
Player's guide to using mods SMAPI mascot.png

This page explains how to install SMAPI (the tool which lets you use mods) on Linux.

See instructions for: Android • macOS • Steam Deck • Windows.

Install

  1. On many Linux distributions, you may need to download and install an older version of libssl (1.1 or 1.x).
  • On Ubuntu, Debian, Linux Mint, and other Debian-based installations, install libssl1.1 (by running sudo apt install libssl1.1 on a terminal).
  • On Arch Linux and its derivatives, install openssl-1.1 by running sudo pacman -S openssl-1.1.
  • Download the latest version of SMAPI.
  • Extract the .zip file somewhere (but not in your game folder!).
  • If you installed Steam through Flatpak, see these instructions:
    instructions for Flatpak 
    When using Flatpak, you need to change the default game location:
    1. Open Steam.
    2. Go to Steam > Settings > Downloads.
    3. Click Steam Library Folders under Content Libraries.
    4. Navigate to /home/[your username]/.local/share/Steam, and click Select.
    5. Make sure the new location you just created is selected, then click "..." and select Make Default.
    6. You may need to uninstall & reinstall the game to move it to the correct folder.
  • Run the install on Linux.sh file, and follow the on-screen instructions.
    (If the installer asks for your game install path, see how to find your game folder.)

    • To install manually instead, see instructions in the installer's readme.

    Update SMAPI

    Just install the new version; the installer will automatically clean up previous versions.

    Uninstall

    1. Launch the installer again (see install steps).
    2. When prompted, choose the uninstall option.

    Troubleshooting

    • If the SMAPI window no longer appears after a game update, reinstall SMAPI to fix the launcher.
    • SMAPI tries to find a compatible terminal or use your default terminal, but some terminals aren't compatible. If the installer or launcher don't launch a terminal, try installing xterm (doesn't need to be your default terminal).
    • See the troubleshooting page for general troubleshooting.
    Retrieved from "https://stardewvalleywiki.com/mediawiki/index.php?title=Modding:Installing_SMAPI_on_Linux&oldid=144521"