-
Notifications
You must be signed in to change notification settings - Fork 45
SECURITY WARNING
RetroNAS installs and enables numerous legacy protocols, many of which are highly insecure by design (in order to be compatible with legacy/retro computers and operating systems). These protocols frequently have known, unfixable exploits due to their legacy nature, and often transmit information such as your Raspberry Pi's usernames and passwords in cleartext (unencrypted). Some of the protocols implemented offer encryption that is very old, and trivially crackable on modern, high-powered CPUs and GPUs.
Do not use RetroNAS to store personal, private or confidential data.
Keep RetroNAS behind a router/firewall on a private network, and never put it on a device with a public IP address.
Putting your entire retro network on a separate subnet or VLAN behind an internal firewall is also recommended if you have the equipment/skills.
All RetroNAS installers run as the "root" (admin) user on your Raspberry Pi in order to make changes to your system. While we intend to make our software as bug-free as possible, this does have the potential to delete your data. Please ensure you have everything backed up before installing any RetroNAS component. All RetroNAS code is open source and available in GitHub should you wish to inspect it yourself.
Please also remember that data on a NAS isn't a backup just by itself. If you care about your data, please have a good backup strategy. Sysadmins often follow the 3-2-1 rule:
- 3 copies of your data in total
- 2 copies onsite on different systems/media
- 1 copy offsite
Likewise any person with a military background will tell you assuredly that "two is one, and one is none". And they are correct.
Fire, flood and fat-fingers can all cause data loss. Please take care.
Getting started:
Contributing
- Bugs
- Structure
- Testing RetroNAS
- Ideas potential future state stuff
Multi-system protocols:
- ADTPro Apple // era
- EtherDFS MS-DOS/FreeDOS
- ethflop MS-DOS/FreeDOS L2 floppy emulator
- FTP
- HTTP
- Kermit
- NFS
- Netatalk AppleTalk/AFP
- Samba SMB/CIFS
- TNFS Atari 8-bit and ZX Spectrum
- Telnet
- ZeroConf, Bonjour, Avahi
- pyGopherd a HTTP alternative
- zterm Serial Comms Zmodem Transfer
Specific system configurations:
- Supported Clients
- 3DS QR codes Nintendo 3DS and 2DS
- Batocera
- EmuELEC and derivatives
- RecalBox
- EmuDeck
- Analogue Pocket (OpenFPGA)
- FSP Nintendo GameCube
- Fenrir-ODE Webserver Sega Saturn
- MiSTer FPGA
- NABU Internet Adapter
- Netlink Sega Saturn Netlink online play
- OpenPS2Loader PlayStation 2
- XBox360
- dreampi dreampi project for Dreamcast (and others) online
- hb-store-cdn PlayStation 4 Homebrew Store CDN
- ps3netsrv PlayStation 3
- linux-dexdrive Dump/Write PS1 memory card images
- sidecart Atari ST Sidecart
Services:
- WaybackProxy Web Proxy through the Wayback Machine
- WebOne Web Proxy
- macproxy Web Proxy
- wrp Web Proxy
- Cockpit Web management
- Syncthing file synchronization
- ROM import Smokemonsters SMDB
- TCPser software Hayes Modem
- BitTorrent
- aria2 lightweight download utility.
- megatools mega.nz suite
- XLink Kai multi-platform
Tools:
- gogrepo Sync your GOG installers
- SabreTools DAT management tool
- mc Midnight Commander (Norton clone)
- ytree filemanger XTree clone
- far2l far2l filemanager
- Gadgets Linux gadgets (OTG) mode
- affstools
- amitools
Physical Media:
- DiscImageCreator dump redump.org compatible images
- Redumper advance disc dumper
On-Device Management:
- cue2pops BIN/CUE to VCD conversion
- extract-xiso Manage XISOs
- hdl-dump PS2 HDD device management
- nbd-client Network Block Device
- pfsshell PFS shell / PFS fuse
- ucon64 A multi-purpose copier device tool
- xboxmanager An experimental XBOX Manager
- pi1541 setup a pi1541 compatible device
Advanced Topics:
- Storage
- BtrFS RAID, Snapshots, Compression, Deduplication
- FAT Advanced guide to using FAT loopback mounts for EtherDFS
- TBA
- SMR Shingled Magnetic Recording hard drives (TBA)
- NTFS Advanced guide for NTFS formatted disks
- SMB Loopback Mounting an existing SMB NAS
- NFS Loopback Mounting an existing NFS NAS
- MDRAID (TBA)
- LVM (TBA)
- iSCSI Configuring iSCSI
- Networking
- Standalone Independent standalone network
- Zoned Firewall zones for retro and modern networks
- DHCP Basic DHCP on the Ethernet device
Other:
- Installation Profiles
- Generic ROMs folder
- Other projects and sites
- laptop-ao
- Local Module
- Docker and why it's not optimal for a network storage system