# TimeMachine

TimeMachine is a self-hosted backup app. TimeMachine provides a Samba-based network share for macOS Time Machine backups, supporting single or multi-user access and optional backup size limits. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/609/timemachine

## Description

TimeMachine provides a Samba-based network share for macOS Time Machine backups, supporting single or multi-user access and optional backup size limits.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

49/100 (Fair), based on 4 of 4 factors.
- Maintained: 53 (last commit 199 days ago)
- Popular: 58 (800 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 40 (4 GB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/mbentley/timemachine
- Unraid: https://ca.unraid.net/apps/timemachine-0j99krj0r9hjkr?q=TimeMachine

## Common questions

### Do date-pinned TimeMachine SMB tags receive updates?

No. Date-specific smb-YYYYMMDD tags are daily snapshots of the smb manifest, remain available for six months, and do not receive security fixes. You must update to newer tags when they are published.

### Is the AFP variant recommended?

No, migrate to the SMB image. AFP is deprecated by Apple, is less stable, and will not receive new feature updates.

### What happens to the persistent volume path if I change TM_USERNAME?

Changing TM_USERNAME changes the persistent volume path. You should check the persistent data path notes before changing that variable.

### How can Macs discover the TimeMachine share over the network?

Run the container with --net=host so Avahi discovery can be used. The README shows an SMB example with host networking for Avahi discovery.

---
Source: Our Local Host (https://ourlocalhost.com/app/609/timemachine), the self-hosted and open-source app directory.