- C 43.8%
- TypeScript 30.6%
- C# 9.9%
- Python 8.6%
- CSS 5.2%
- Other 1.9%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| clients | ||
| deploy | ||
| server | ||
| shared | ||
| tests | ||
| web | ||
| .dockerignore | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| docker-compose.yml | ||
| Dockerfile | ||
| Dockerfile.pkhex | ||
| install-devkitpro-pacman | ||
| LICENSE | ||
| Pockettransfer.slnx | ||
| Program.cs | ||
| README.md | ||
Pockettransfer
A Self-hostable (I don't wish that upon you) Pokémon Bank / HOME-style storage for modded 3DS and Switch. A Next.js app owns the web UI, cookies, and console HTTP API. A private C# sidecar runs PKHeX.Core for save writes and legality. Banked Pokémon live in PostgreSQL.
My Site pockettransfer.net
Server: Proxmox Docker LXC + Nginx Proxy Manager
- Pockettransfer runs in the Docker LXC (
./deploy/proxmox/up.sh→ port 8080). Compose starts Postgres, the PKHeX sidecar (internal only), and the Next.js web app. - Nginx Proxy Manager terminates HTTPS for
https://your-website.comand proxies to the LXC.
| Component | Guide |
|---|---|
| Docker LXC deploy | deploy/proxmox/README.md |
NPM + your-website.com |
deploy/nginx-proxy-manager.md |
Do not use docker compose --profile tls when NPM handles certificates.
Console config.json example: deploy/config.example.json
Health (on LXC): curl http://127.0.0.1:8080/health
After upgrading from the old ASP.NET cookie app, log in again in the browser. Paired consoles keep their device tokens.
Local dev (Postgres + Next.js + PKHeX sidecar)
cp .env.example .env # set POSTGRES\_PASSWORD
docker compose up -d postgres
export PATH="$HOME/.dotnet:$PATH"
dotnet run --project server # PKHeX sidecar on :8081
cd web
cp .env.example .env # DATABASE\_URL + PKHEX\_URL
npm install
npx prisma db push
npm run dev # http://localhost:3000
Web UI
Open your NPM URL in a browser on PC or phone:
- Register with a username and password (3–32 chars, lowercase letters, numbers, underscore).
- Log in → My Bank to browse boxes, search Pokémon, and view PKHeX legality reports.
- Devices to pair 3DS/Switch · Saves to upload a save file from the browser.
The oldest account is an admin. Admins see Admin in the nav: manage users, inspect boxes, reset passwords, revoke devices. Set PT\_ADMIN\_USERNAMES (comma-separated) to always grant those usernames admin on startup.
Console clients
CFW required. First launch: create an account or log in with the console keyboard — the app stores the device token itself.
- 3DS: clients/3ds (PKSM-style dual-screen UI)
- Switch: clients/switch (Pokémon HOME-style 720p UI; high-res art from
GET /sprites/home/{key}.pngon this host)
Title IDs: shared/GAMES.md · TLS: shared/tls.md
License
The PKHeX sidecar uses PKHeX.Core (GPL-3.0-or-later). See LICENSE.
Small Test