528
edits
Changes
mLine 1:
Line 1: − + − + − * [[Modding:Installing SMAPI on Android|Instructions for Android]]+ − * [[Modding:Installing SMAPI on Mac|Instructions for macOS]]+ − * [[Modding:Installing SMAPI on Windows|Instructions for Windows]] Line 21:
Line 20: − + Line 37:
Line 36: + + + + + + + + + + + + + + + + + + + + + + + + + + Line 45:
Line 70: +
→Troubleshooting
{{Modding:Player Guide/header}}
{{modding player guide header}}
This page explains how to install SMAPI (the tool which lets you use mods) on Linux. This guide also applies for the Steam Deck's distribution of Linux, SteamOS. See also:
This page explains how to install SMAPI (the tool which lets you use mods) on Linux.
See instructions for: [[Modding:Installing SMAPI on Android|Android]] • [[Modding:Installing SMAPI on Mac|macOS]] • [[Modding:Installing SMAPI on Steam Deck|Steam Deck]] • [[Modding:Installing SMAPI on Windows|Windows]].
__TOC__
__TOC__
# You may need to uninstall & reinstall the game to move it to the correct folder.
# You may need to uninstall & reinstall the game to move it to the correct folder.
}}</li>
}}</li>
<li>Run the <samp>install on Linux.sh</samp> file, and follow the on-screen instructions.<br />(If it the installer asks for your game install path, see [[Modding:Player Guide/Getting Started#Find your game folder|how to find your game folder]].)</li>
<li>Run the <samp>install on Linux.sh</samp> file, and follow the on-screen instructions.<br />(If the installer asks for your game install path, see [[Modding:Player Guide/Getting Started#Find your game folder|how to find your game folder]].)</li>
</ol>
</ol>
* 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).
* 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 [[Modding:Player Guide/Troubleshooting|troubleshooting page]] for general troubleshooting.
* See the [[Modding:Player Guide/Troubleshooting|troubleshooting page]] for general troubleshooting.
* If you're trying to install SMAPI for Stardew 1.5.6, be forewarned you need to install libssl1.x. See below for instructions:
{| class="wikitable"
|-
! distros
! prerequisites
|-
| Debian-based<br /><small>(Debian, Ubuntu, Linux Mint)</small>
| Install LibSSL 1.1 by running <code>sudo apt install libssl1.1</code> in a terminal.
|-
| Arch-based<br /><small>(Arch, Manjaro, EndeavourOS)</small>
| Install OpenSSL 1.1 by running <code>sudo pacman -S openssl-1.1</code> in a terminal.
|-
| NixOS
| Use [https://search.nixos.org/packages?channel=unstable&show=steam-run&type=packages steam-run] to run <samp>install on Linux.sh</samp> in the steps below.<br /><small>(Make sure your system has steam-run installed, or create a temporary nix-shell with steam-run by executing <code>export NIXPKGS_ALLOW_UNFREE=1 && nix-shell -p steam-run</code>. Then run <code>steam-run ./install\ on\ Linux.sh</code> in a terminal to start the installation.)</small>
|-
| Fedora
| Install OpenSSL 1.1 by running <code>sudo dnf install openssl1.1</code> in a terminal.
|-
| Gentoo
| Install OpenSSL 1.1 compatibility by running <code>sudo emerge --ask dev-libs/openssl-compat</code> in a terminal.
|-
| RHEL 8-based <br /><small>(RHEL 8, CentOS 8, Rocky 8, Alma 8)</small>
| Install OpenSSL 1.1 by running <code>sudo dnf install openssl</code> in a terminal.
|}
{{Modding guide footer
{{Modding guide footer
[[de:Modding:SMAPI auf Linux]]
[[de:Modding:SMAPI auf Linux]]
[[es:Modding:Instalar SMAPI en Linux]]
[[es:Modding:Instalar SMAPI en Linux]]
[[fr:Modding:Installer SMAPI sur Linux]]
[[zh:模组:在Linux上安装SMAPI]]
[[zh:模组:在Linux上安装SMAPI]]