Modding:Installing SMAPI on Linux - Revision history

imported>AndromedaVii: /* Install */ Added instruction to make necessary files executable.

2026-02-08T09:20:19Z

Install: Added instruction to make necessary files executable.

← Older revision		Revision as of 09:20, 8 February 2026
Line 11:		Line 11:
	<li>Download the [https://smapi.io/ latest version of SMAPI].</li>		<li>Download the [https://smapi.io/ latest version of SMAPI].</li>
	<li>Extract the <samp>.zip</samp> file somewhere (but not in your game folder!).</li>		<li>Extract the <samp>.zip</samp> file somewhere (but not in your game folder!).</li>
			<li>Ensure that the files "'''install on Linux.sh'''" and "'''internal/linux/SMAPI.Installer'''" are marked as executable, either with your file explorer or by opening a terminal in the extracted directory and entering the command: '''<samp>chmod +x "./install on Linux.sh" "./internal/linux/SMAPI.Installer"</samp>'''</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]].)<br />'''WARNING:''' The <samp>install on Linux.sh</samp> '''has to be run''' in a terminal window using <samp>./install\ on\ Linux.sh</samp> (assuming your terminal window's path is inside the SMAPI installer folder) as there is a bug that can cause issues with the system's syslog by continuously writing log entries for SMAPI versions older than 4.1.0 (which is currently not released). <br />In case the .sh file was run via GUI (i.e. double-clicked) instead of via terminal it can be safely terminated through a GUI task manager or through the <samp>kill -SIGINT [PID]</samp> command where [PID] is the process ID of the running shell process. </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]].)<br />'''WARNING:''' The <samp>install on Linux.sh</samp> '''has to be run''' in a terminal window using <samp>./install\ on\ Linux.sh</samp> (assuming your terminal window's path is inside the SMAPI installer folder) as there is a bug that can cause issues with the system's syslog by continuously writing log entries for SMAPI versions older than 4.1.0 (which is currently not released). <br />In case the .sh file was run via GUI (i.e. double-clicked) instead of via terminal it can be safely terminated through a GUI task manager or through the <samp>kill -SIGINT [PID]</samp> command where [PID] is the process ID of the running shell process. </li>
	</ol>		</ol>
Line 18:		Line 19:
	===SMAPI with Proton===		===SMAPI with Proton===
	To make SMAPI work with Proton, you can follow the guide available on [[Modding:Installing SMAPI on Steam Deck#Stardew Valley in Proton\|Stardew Valley in Proton]].		To make SMAPI work with Proton, you can follow the guide available on [[Modding:Installing SMAPI on Steam Deck#Stardew Valley in Proton\|Stardew Valley in Proton]].


	==Update SMAPI==		==Update SMAPI==

imported>MrGarlic: SMAPI does not need any special setup for flatpak steam anymore; it can use the default game folder.

2025-08-24T00:16:05Z

SMAPI does not need any special setup for flatpak steam anymore; it can use the default game folder.

← Older revision		Revision as of 00:16, 24 August 2025
Line 11:		Line 11:
	<li>Download the [https://smapi.io/ latest version of SMAPI].</li>		<li>Download the [https://smapi.io/ latest version of SMAPI].</li>
	<li>Extract the <samp>.zip</samp> file somewhere (but not in your game folder!).</li>		<li>Extract the <samp>.zip</samp> file somewhere (but not in your game folder!).</li>
	~~<li>If you installed Steam through Flatpak, see these instructions:~~
	~~{{collapse\|instructions for Flatpak\|content=When using Flatpak, you need to change the default game location:~~
	~~# Open Steam.~~
	~~# Go to ''Steam > Settings > Downloads''.~~
	~~# Click ''Steam Library Folders'' under ''Content Libraries''.~~
	~~# Navigate to <samp>/home/[your username]/.local/share/Steam</samp>, and click ''Select''.~~
	~~# Make sure the new location you just created is selected, then click "''...''" and select ''Make Default''.~~
	~~# You may need to uninstall & reinstall the game to move it to the correct 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]].)<br />'''WARNING:''' The <samp>install on Linux.sh</samp> '''has to be run''' in a terminal window using <samp>./install\ on\ Linux.sh</samp> (assuming your terminal window's path is inside the SMAPI installer folder) as there is a bug that can cause issues with the system's syslog by continuously writing log entries for SMAPI versions older than 4.1.0 (which is currently not released). <br />In case the .sh file was run via GUI (i.e. double-clicked) instead of via terminal it can be safely terminated through a GUI task manager or through the <samp>kill -SIGINT [PID]</samp> command where [PID] is the process ID of the running shell process. </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]].)<br />'''WARNING:''' The <samp>install on Linux.sh</samp> '''has to be run''' in a terminal window using <samp>./install\ on\ Linux.sh</samp> (assuming your terminal window's path is inside the SMAPI installer folder) as there is a bug that can cause issues with the system's syslog by continuously writing log entries for SMAPI versions older than 4.1.0 (which is currently not released). <br />In case the .sh file was run via GUI (i.e. double-clicked) instead of via terminal it can be safely terminated through a GUI task manager or through the <samp>kill -SIGINT [PID]</samp> command where [PID] is the process ID of the running shell process. </li>
	</ol>		</ol>

imported>Margotbean: internal link format

2025-07-27T21:39:13Z

internal link format

← Older revision		Revision as of 21:39, 27 July 2025
Line 26:		Line 26:

	===SMAPI with Proton===		===SMAPI with Proton===
	To make SMAPI work with Proton, you can follow the guide available on [~~https://stardewvalleywiki.com/~~Modding:~~Installing_SMAPI_on_Steam_Deck~~#~~Stardew_Valley_in_Proton~~ Stardew Valley in Proton].		To make SMAPI work with Proton, you can follow the guide available on [[Modding:Installing SMAPI on Steam Deck#Stardew Valley in Proton\|Stardew Valley in Proton]].

imported>Shg: Change link text

2025-07-27T08:17:41Z

Change link text

← Older revision		Revision as of 08:17, 27 July 2025
Line 26:		Line 26:

	===SMAPI with Proton===		===SMAPI with Proton===
	To make SMAPI work with Proton, you can follow the guide available [https://stardewvalleywiki.com/Modding:Installing_SMAPI_on_Steam_Deck#Stardew_Valley_in_Proton ~~here~~].		To make SMAPI work with Proton, you can follow the guide available on [https://stardewvalleywiki.com/Modding:Installing_SMAPI_on_Steam_Deck#Stardew_Valley_in_Proton Stardew Valley in Proton].


	==Update SMAPI==		==Update SMAPI==

imported>Shg: Adding a reference to a guide on making SMAPI work with Proton that was already covered on the Steam Deck page. Linux users often want to run Stardew Valley with Proton. Recently, there's been a bug making co-op only work in Proton and it is not easy to find a way to both enable SMAPI and Proton at the same time.

2025-07-27T08:15:41Z

Adding a reference to a guide on making SMAPI work with Proton that was already covered on the Steam Deck page. Linux users often want to run Stardew Valley with Proton. Recently, there's been a bug making co-op only work in Proton and it is not easy to find a way to both enable SMAPI and Proton at the same time.

← Older revision		Revision as of 08:15, 27 July 2025
Line 24:		Line 24:

	<small>To install manually instead, see instructions in the installer's readme.</small>		<small>To install manually instead, see instructions in the installer's readme.</small>

			===SMAPI with Proton===
			To make SMAPI work with Proton, you can follow the guide available [https://stardewvalleywiki.com/Modding:Installing_SMAPI_on_Steam_Deck#Stardew_Valley_in_Proton here].

	==Update SMAPI==		==Update SMAPI==

imported>Marr.u: There is a very serious bug that occurs if the install sh file is run incorrectly. Instructions were added to the install steps to help avoid such a scenario.

2024-08-22T18:45:46Z

There is a very serious bug that occurs if the install sh file is run incorrectly. Instructions were added to the install steps to help avoid such a scenario.

← Older revision		Revision as of 18:45, 22 August 2024
Line 20:		Line 20:
	# 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 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]].)<br />'''WARNING:''' The <samp>install on Linux.sh</samp> '''has to be run''' in a terminal window using <samp>./install\ on\ Linux.sh</samp> (assuming your terminal window's path is inside the SMAPI installer folder) as there is a bug that can cause issues with the system's syslog by continuously writing log entries for SMAPI versions older than 4.1.0 (which is currently not released). <br />In case the .sh file was run via GUI (i.e. double-clicked) instead of via terminal it can be safely terminated through a GUI task manager or through the <samp>kill -SIGINT [PID]</samp> command where [PID] is the process ID of the running shell process. </li>
	</ol>		</ol>

imported>Margotbean: category

2024-08-07T20:20:48Z

imported>Peaw at 05:20, 18 July 2024

2024-07-18T05:20:03Z

← Older revision		Revision as of 05:20, 18 July 2024
Line 74:		Line 74:
	[[es:Modding:Instalar SMAPI en Linux]]		[[es:Modding:Instalar SMAPI en Linux]]
	[[fr:Modding:Installer SMAPI sur Linux]]		[[fr:Modding:Installer SMAPI sur Linux]]
			[[tr:Modlama:Linux'ta SMAPI İndirme]]
	[[zh:模组:在Linux上安装SMAPI]]		[[zh:模组:在Linux上安装SMAPI]]

imported>Margotbean: /* Troubleshooting */ update from User: Mariechen caught in new user hyperlink filter

2024-07-16T18:28:32Z

Troubleshooting: update from User: Mariechen caught in new user hyperlink filter

← Older revision		Revision as of 18:28, 16 July 2024
Line 51:		Line 51:
	\|-		\|-
	\| NixOS		\| 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>		\| Use [https://search.nixos.org/packages?channel=unstable&show=steam-run&type=packages steam-run] to run <samp>install on Linux.sh</samp>.
			# In case you don't have steam installed, enter a shell with steam-run available: <code>NIXPKGS_ALLOW_UNFREE=1 nix-shell -p steam-run</code>.
			# Run this command to start the installer: <code>steam-run ./install\ on\ Linux.sh</code>
			<small>The <code>./</code> is very important, otherwise it will NOT work!</small>
	\|-		\|-
	\| Fedora		\| Fedora

imported>Atravita: /* Troubleshooting */

2024-04-18T01:47:19Z

Troubleshooting

@@ Line 36: / Line 36: @@
 * 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.
 {{Modding guide footer

← Older revision		Revision as of 20:20, 7 August 2024
Line 70:		Line 70:
	\|next =		\|next =
	}}		}}

			[[Category:Modding]]

	[[de:Modding:SMAPI auf Linux]]		[[de:Modding:SMAPI auf Linux]]