{% extends "base.html" %} {% block content %} {% include 'nav.html' %}

Setup Guide

Supported Clients

Ownfoil supports the following Nintendo Switch clients:

{% if tinfoil_enabled %}

Tinfoil

  • HTTP / HTTPS protocol support
  • User authentication
  • Shop browsing with icons and banners
  • Content filtering (games, updates, DLC, XCI) based on URL
  • New games, DLC, Updates, Recommended and XCI sections
  • Compressed content (NSZ and XCZ) support
  • Encrypted shop support
  • Client side Host verification for secure connections
  • Custom welcome message (MOTD)
{% endif %} {% if sphaira_enabled %}

Sphaira

  • HTTP / HTTPS protocol support
  • User authentication
  • Directory-based file browsing
  • Content filtering (games, updates, DLC, XCI) based on URL
  • Compressed content (NSZ and XCZ) support
{% endif %} {% if cyberfoil_enabled %}

CyberFoil

  • HTTP / HTTPS protocol support
  • User authentication
  • Shop browsing with icons and Sections (Updates, DLC)
  • Compressed content (NSZ and XCZ) support
  • Client side Host verification for secure connections
  • Custom welcome message (MOTD)
{% endif %}

Setup Instructions

{% if show_local_tab %}
{% else %}
{% endif %}
Local Access is for when your Nintendo Switch and Ownfoil server are on the same network (e.g., both on your home WiFi).
{% if not local_address %}
Unable to determine local server address. Please check your network configuration.
{% else %}
{% if tinfoil_enabled %}
  1. On your Nintendo Switch, open Tinfoil
  2. Navigate to File Browser → New
  3. Enter the following details:
    {% if not shop_public %} {% endif %}
    Protocol: http
    Host: {{ local_address }}
    Port: {{ local_port }}
    Path: / for all content, else one of /base, /update, /dlc, /multi to serve specific content.
    Username: Username
    Password: Password
    Title: Ownfoil - Local
    Enabled: YES
  4. Press Save to save the location and load the shop
{% endif %} {% if sphaira_enabled %}

  1. On your Nintendo Switch, open Sphaira
  2. Open Menu → Advanced Options → Install options and turn on Enable emummc
  3. Open Menu → Advanced Options → Add / modify mounts → Create New Entry
  4. Enter the following details:
    {% if not shop_public %} {% endif %}
    Type: HTTP
    Name: Ownfoil - Local
    URL: http://{{ local_address }} Add /base, /update, /dlc, /multi to serve specific content.
    Port: {{ local_port }}
    User: Username
    Pass: Password
  5. Press Save and restart Sphaira
  6. Navigate to FileBrowser → Options → Mount → Select [HTTP] Ownfoil - Local
Opening a file will show a preview of its content. To actually install the file, press Options → Install.
To refresh the shop, simply select another Mount then select back Ownfoil.
{% endif %} {% if cyberfoil_enabled %}

  1. On your Nintendo Switch, open CyberFoil
  2. Open Settings → Shop → Add new shop
  3. Enter the following details:
    {% if not shop_public %} {% endif %}
    Shop title: Ownfoil - Local
    Shop protocol: HTTP
    Host: {{ local_address }}
    Port: {{ local_port }}
    Username: Username
    Password: Password
  4. Ensure Active shop is set to the correct shop
  5. Press Back to go back to the main menu, and open Install from eShop to browse your shop
{% endif %}
{% endif %}
{% if show_local_tab %}
{% else %}
{% endif %}
Remote Access allows you to access your Ownfoil shop from anywhere over the internet. Requires proper port forwarding or a reverse proxy setup.
{% if not remote_host %}
Remote host not configured. Please configure the remote host in the Settings page under the Shop section.
{% else %}
{% if tinfoil_enabled %}
  1. On your Nintendo Switch, open Tinfoil
  2. Navigate to File Browser → New
  3. Enter the following details:
    {% if not shop_public %} {% endif %}
    Protocol: https
    Host: {{ remote_host }}
    Path: / for all content, else one of /base, /update, /dlc, /multi to serve specific content.
    Username: Username
    Password: Password
    Title: Ownfoil - Remote
    Enabled: YES
  4. Press Save to save the location and load the shop
{% endif %} {% if sphaira_enabled %}

  1. On your Nintendo Switch, open Sphaira
  2. Open Menu → Advanced Options → Install options and turn on Enable emummc
  3. Open Menu → Advanced Options → Add / modify mounts → Create New Entry
  4. Enter the following details:
    {% if not shop_public %} {% endif %}
    Type: HTTP
    Name: Ownfoil - Remote
    URL: https://{{ remote_host }}{{ sphaira_endpoint }} Append /base, /update, /dlc, /multi to serve specific content.
    Port: 443
    User: Username
    Pass: Password
  5. Press Save and restart Sphaira
  6. Navigate to FileBrowser → Options → Mount → Select [HTTP] Ownfoil - Remote
Sphaira does not identify itself in its requests, the {{ sphaira_endpoint }} part of the URL is required for remote access so that Ownfoil can serve the Sphaira shop behind a reverse proxy.
Opening a file will show a preview of its content. To actually install the file, press Options → Install.
To refresh the shop, simply select another Mount then select back Ownfoil.
{% endif %} {% if cyberfoil_enabled %}

  1. On your Nintendo Switch, open CyberFoil
  2. Open Settings → Shop → Add new shop
  3. Enter the following details:
    {% if not shop_public %} {% endif %}
    Shop title: Ownfoil - Remote
    Shop protocol: HTTPS
    Host: {{ remote_host }}
    Port: 443
    Username: Username
    Password: Password
  4. Ensure Active shop is set to the correct shop
  5. Press Back to go back to the main menu, and open Install from eShop to browse your shop
{% endif %}
{% endif %}
{% endblock %}