Switch Games Server

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

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