Switch Game Server

pt-BR

Servidor HTTP simples para hospedar jogos Nintendo Switch (NSP, NSZ, DLCs) e acessá-los via Tinfoil.

en

Simple HTTP server to host Nintendo Switch games (NSP, NSZ, DLCs) and access them via Tinfoil.

---

Requisitos | Requirements

pt-BR

• Servidor Debian 13 (ou similar) com Apache e PHP instalados
• Jogos organizados nas pastas roms/ e dlc/ dentro do diretório do servidor
• Nintendo Switch com Tinfoil instalado e acesso à mesma rede local do servidor

en

• Debian 13 server (or similar) with Apache and PHP installed
• Games organized in roms/ and dlc/ folders inside the server directory
• Nintendo Switch with Tinfoil installed and connected to the same local network as the server

---

Configuração do Servidor | Server Setup

1. Instalar Apache e PHP | Install Apache and PHP

sudo apt update
sudo apt install apache2 php libapache2-mod-php -y

2. Configurar o VirtualHost do Apache | Configure VirtualHost

pt-BR

• Crie o arquivo /etc/apache2/sites-available/switch_store.conf com o conteúdo:

en

• Create the file /etc/apache2/sites-available/switch_store.conf with the following content:

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    ServerName switch_store.local
    ServerAlias SERVER_IP
    DocumentRoot /var/www/switch_store

    <Directory /var/www/switch_store>
        Options Indexes FollowSymLinks
        AllowOverride None
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/switch_store_error.log
    CustomLog ${APACHE_LOG_DIR}/switch_store_access.log combined
</VirtualHost>

3. Habilitar o site e reiniciar Apache | Enable site and restart Apache

sudo a2ensite switch_store.conf
sudo systemctl reload apache2

4. Configurar /etc/hosts no PC (opcional) | Configure /etc/hosts (optional)

pt-BR

• Adicione a linha abaixo no arquivo /etc/hosts do seu PC:

en

• Add the following line to your computer’s /etc/hosts file:

192.168.100.244 switch_store.local

pt-BR

• Coloque seus jogos NSP/NSZ na pasta /var/www/switch_store/roms
• Coloque seus DLCs na pasta /var/www/switch_store/dlc
• Use o script index.php para listar os arquivos (exemplo disponível no repositório)

en

• Place your NSP/NSZ games in /var/www/switch_store/roms
• Place your DLCs in /var/www/switch_store/dlc
• Use the index.php script to list files (example available in the repository)

4. Configuração no Nintendo Switch (Tinfoil) | Nintendo Switch (Tinfoil) Setup

pt-BR

Abra o Tinfoil no Switch. Vá em Gerenciador de Arquivos > Adicionar Fonte de Rede.

Configure os campos:

Protocol: http
Host: IP do servidor (ex: 192.168.100.244)
Port: 80
Path: / (deixe como / ou vazio)
Username/Password: deixe em branco (a menos que seu servidor exija)
Title: nome amigável para a fonte (ex: Loja do Xxxx)
Enabled: SIM

Salve a fonte. Acesse a fonte criada e navegue pelos jogos listados.

en

On the Switch, open Tinfoil → File Browser → Add New Network Location. Fill in the fields:

   Protocol: http
   Host: server IP (e.g., 192.168.100.244)
   Port: 80
   Path: / (or leave blank)
   Username/Password: leave empty (unless required)
   Title: friendly name (e.g., Xxxx Store)
   Enabled: YES

Save and browse the games.

5. Permissões recomendadas no servidor | Recommended Permissions

pt-BR

Para garantir que o Apache possa acessar os arquivos:

en

To ensure Apache can access the files:

sudo chown -R www-data:www-data /var/www/switch_store
sudo find /var/www/switch_store -type d -exec chmod 755 {} \;
sudo find /var/www/switch_store -type f -exec chmod 644 {} \;
sudo systemctl restart apache2

Dicas | Tips

pt-BR

Reinicie o Switch e o Tinfoil se os jogos não aparecerem Use nomes simples e sem espaços nos arquivos Certifique-se de que o Switch e o servidor estão na mesma rede local

en

Restart the Switch and Tinfoil if games don’t show up Use simple filenames without spaces Make sure both the Switch and the server are on the same local network