# Time Capsule Migration from AFP to Samba: Open-Source Project for macOS Support
Developer James Chang has released the TimeCapsuleSMB project on GitHub, replacing the AFP protocol with Samba in Apple Time Capsule network storage devices. This will allow using the devices after AFP is fully disabled in future macOS versions, including the expected macOS 27.
Time Capsule devices are NAS units with built-in routers, released starting in 2008. They provide file storage and Time Machine backups. AFP (Apple Filing Protocol)—their core protocol—is now deprecated. Without migration, the storages will become incompatible.
History and Specifics of Time Capsule
Apple produced five generations of these devices. The first four feature a distinctive white cylindrical design, while the fifth has a more compact white enclosure. All models rely on AFP for network access.
- AFP vs. Samba: AFP is obsolete, while Samba (SMB/CIFS) is the de facto standard for cross-platform file sharing.
- The Issue: macOS is gradually phasing out AFP; it's already not recommended in Apple's corporate documentation.
- Solution: TimeCapsuleSMB migrates traffic to Samba, preserving compatibility.
The project addresses the issue at the firmware level: Samba is compiled for the Time Capsule environment (based on BusyBox and MIPS/PowerPC architectures).
Migration Steps According to the Project Instructions
The process requires SSH access and manual building. Main stages:
- Enable SSH: Use AirPort Utility (AirPyrt for newer versions) to turn on remote access. Command:
ssh root@<IP>with the default password. - Build Samba: Download Samba 4.x sources, configure cross-compilation for the device architecture (mipsel or ppc). Example configuration:
```bash
./configure --host=mipsel-unknown-linux-gnu --prefix=/usr/local/samba --without-ads --without-dnsupdate
make
```
- Installation: Transfer the binaries to the device, stop the AFP server (
afpd -k). - Port Redirection: Use iptables to redirect AFP ports (548/tcp) to Samba (445/tcp). Example:
```bash
iptables -t nat -A PREROUTING -p tcp --dport 548 -j REDIRECT --to-port 445
```
- Samba Configuration: smb.conf with sections for Time Machine (fruit:time machine = yes).
The repository includes automation scripts and a Dockerfile for building.
Technical Implementation Details
Time Capsule runs on modified firmware—a minimalistic Linux distribution without a package manager. Samba is adapted with disabled modules (ADS, Kerberos) to reduce load on 256–512 MB RAM.
- Compatibility: Tested on models A1254–A1470 (generations 1–5).
- Limitations: No SMB3 multi-channel support; performance on par with AFP (~50–100 MB/s over Gigabit).
- Security: Samba with NTLMv2, but VPN recommended for external access.
The project is open-source (MIT license), and the community can refine it for specific hardware revisions.
Key Points
- TimeCapsuleSMB is the only open-source way to extend the life of Time Capsule devices after AFP is disabled.
- Migration requires embedded development and network configuration skills.
- Samba ensures cross-platform compatibility: macOS, Windows, Linux.
- The repository instructions minimize the risk of bricking the device.
- Relevant for owners of legacy hardware without upgrades.
— Editorial Team
No comments yet.