Switch Games Server: Difference between revisions

Switch Games Server
Switch Games Server
General
Author	gonzartur
Type	PC Utilities
Version	1.0.3
License	CC BY-NC-SA 4.0
Last Updated	2026/03/29
Links
	Download
	Website
	Source

Latest revision as of 04:45, 5 April 2026

Switch Games Server (SGS) is a Laravel-based HTTP server that serves your Switch game files (NSP/NSZ/XCI/XCZ) from your PC over your local network. It lets you install games onto your Switch directly over Wi-Fi using:

Tinfoil (via "other" or "URL" source)
DBI (via "Home server" / HTTP install)

Features

Network File Sharing - Share your Switch game files (.nsz, .nsp, .xci, .xcz) over the network.
Tinfoil Support - JSON-based file index for Tinfoil app.
DBI Support - Apache-style directory listing for DBI app.
Docker Ready - Fully containerized with Docker Compose.
Auto Setup - Automatic dependency installation on first run.

Quick Start

git clone https://github.com/notf0und/SGS
cd SGS
docker-compose up -d

That's it! The app automatically handles:

Composer dependencies
NPM packages and builds
Storage symlinks

Just add your game files to the games/ folder and access the web interface for setup guides.

Supported

.nsz - Compressed NSP
.nsp - Nintendo Submission Package
.xci - NX Card Image
.xcz - Compressed XCI

Changelog

v1.0.3

Add PR templates, CI workflows, and release drafter config files @notf0und (#8)

v1.0.2

Update Docker image name to use DockerHub username and repo name dynamically by @notf0und in #7

v1.0.1

Add prod environment to Docker job in release workflow by @notf0und in #6

v1.0.0

Fixes #3: Error on DBI when files or folders contains special characters. by @notf0und in #4
Add testing to .dockerignore and update composer test scripts by @notf0und in #5

External links

@@ Line 4: / Line 4: @@
 |description=Install games on your Switch wirelessly using Tinfoil or DBI!
 |author=gonzartur
-|lastupdated=2025/12/26
+|lastupdated=2026/03/29
 |type=PC Utilities
-|version=2015
+|version=1.0.3
 |license=CC BY-NC-SA 4.0
 |download=https://dlhb.gamebrew.org/switchhomebrews/SwitchGamesServerSwitch.7z
@@ Line 20: / Line 20: @@
 }}
 Switch Games Server (SGS) is a Laravel-based HTTP server that serves your Switch game files (NSP/NSZ/XCI/XCZ) from your PC over your local network. It lets you install games onto your Switch directly over Wi-Fi using:
 * Tinfoil (via "other" or "URL" source)
 * DBI (via "Home server" / HTTP install)
-This avoids manually copying files to the SD card or using USB cables, making it easy to install large games or maintain a "private shop" on your home network.
 == Features ==
-* Network Installation - No more cables! Install games directly from your server
+* Network File Sharing - Share your Switch game files (.nsz, .nsp, .xci, .xcz) over the network.
-* Multi-Device - All Switch consoles on your network can access the same game library
+* Tinfoil Support - JSON-based file index for Tinfoil app.
-* Tinfoil & DBI Support - Works with both popular homebrew installers
+* DBI Support - Apache-style directory listing for DBI app.
-* Docker-Ready - One command setup with Docker Compose
+* Docker Ready - Fully containerized with Docker Compose.
-* Auto-Setup - Automatically installs dependencies and builds assets on first run
+* Auto Setup - Automatic dependency installation on first run.
-* Built-in Documentation - Step-by-step guides with screenshots included
 == Quick Start ==
@@ Line 51: / Line 47: @@
 * .xci - NX Card Image
 * .xcz - Compressed XCI
+==Changelog==
+'''v1.0.3'''
+* Add PR templates, CI workflows, and release drafter config files [https://github.com/notf0und @notf0und] ([https://github.com/notf0und/SGS/pull/8 #8])
+'''v1.0.2'''
+* Update Docker image name to use DockerHub username and repo name dynamically by [https://github.com/notf0und @notf0und] in [https://github.com/notf0und/SGS/pull/7 #7]
+'''v1.0.1'''
+* Add prod environment to Docker job in release workflow by [https://github.com/notf0und @notf0und] in [https://github.com/notf0und/SGS/pull/6 #6]
+'''v1.0.0'''
+* Fixes [https://github.com/notf0und/SGS/issues/3 #3]: Error on DBI when files or folders contains special characters. by [https://github.com/notf0und @notf0und] in [https://github.com/notf0und/SGS/pull/4 #4]
+* Add testing to .dockerignore and update composer test scripts by [https://github.com/notf0und @notf0und] in [https://github.com/notf0und/SGS/pull/5 #5]
 == External links ==
-* Gbatemp - https://gbatemp.net/threads/video-game-sgs-switch-games-server-install-games-on-your-switch-wirelessly-using-tinfoil-or-dbi.678378/
+* GitHub - https://github.com/notf0und/SGS
-* Github - https://github.com/notf0und/SGS
+* GBAtemp - https://gbatemp.net/threads/video-game-sgs-switch-games-server-install-games-on-your-switch-wirelessly-using-tinfoil-or-dbi.678378/