# tmutil — Time-Machine-Backups steuern

> Praxis-Guide zu tmutil: Time Machine per Kommandozeile steuern — Backups starten, Snapshots verwalten, Ziele setzen und Dateien wiederherstellen.

Source: https://www.jpkc.com/db/cheatsheets/macos/tmutil/

<!-- PROSE:intro -->
tmutil steuert Apples Time Machine direkt von der Kommandozeile – du startest und stoppst Backups, setzt Backup-Ziele, verwaltest lokale APFS-Snapshots und stellst einzelne Dateien wieder her, ganz ohne den Umweg über die Systemeinstellungen. Das ist besonders praktisch für Skripte, Wartungsroutinen und Server-Macs ohne dauerhaft angemeldeten Nutzer. Dieser Guide zeigt dir die wichtigsten Unterbefehle für den Alltag, von der Backup-Steuerung bis zur gezielten Wiederherstellung.
<!-- PROSE:intro:end -->

## Backup-Steuerung

`tmutil startbackup` — Startet sofort ein Time-Machine-Backup.

```bash
sudo tmutil startbackup
```

`tmutil startbackup --auto` — Startet ein automatisches Backup (kann vom System aufgeschoben werden).

```bash
sudo tmutil startbackup --auto
```

`tmutil startbackup --block` — Startet ein Backup und wartet, bis es abgeschlossen ist.

```bash
sudo tmutil startbackup --block
```

`tmutil stopbackup` — Stoppt ein laufendes Backup.

```bash
sudo tmutil stopbackup
```

`tmutil enable` — Aktiviert automatische Time-Machine-Backups.

```bash
sudo tmutil enable
```

`tmutil disable` — Deaktiviert automatische Time-Machine-Backups.

```bash
sudo tmutil disable
```

## Status & Informationen

`tmutil status` — Zeigt den aktuellen Status des Time-Machine-Backups.

```bash
tmutil status
```

`tmutil currentphase` — Zeigt die aktuelle Phase eines laufenden Backups.

```bash
tmutil currentphase
```

`tmutil listbackups` — Listet alle verfügbaren Backups auf (Pfade).

```bash
tmutil listbackups
```

`tmutil latestbackup` — Zeigt den Pfad des jüngsten Backups.

```bash
tmutil latestbackup
```

`tmutil destinationinfo` — Zeigt Informationen zu den Backup-Zielen.

```bash
tmutil destinationinfo
```

`tmutil machinedirectory` — Zeigt den maschinenspezifischen Backup-Verzeichnispfad.

```bash
tmutil machinedirectory
```

## Snapshots

`tmutil localsnapshot` — Erstellt einen neuen lokalen APFS-Snapshot.

```bash
sudo tmutil localsnapshot
```

`tmutil listlocalsnapshots /` — Listet alle lokalen Snapshots eines Volumes auf.

```bash
tmutil listlocalsnapshots /
```

`tmutil listlocalsnapshotdates` — Listet die Daten aller lokalen Snapshots auf.

```bash
tmutil listlocalsnapshotdates
```

`tmutil deletelocalsnapshots <date>` — Löscht einen bestimmten lokalen Snapshot anhand des Datums.

```bash
sudo tmutil deletelocalsnapshots 2026-03-19-120000
```

`tmutil thinlocalsnapshots / <bytes>` — Löscht lokale Snapshots, bis der angegebene Speicherplatz frei ist.

```bash
sudo tmutil thinlocalsnapshots / 10000000000
```

## Ausschlüsse

`tmutil addexclusion <path>` — Schließt einen Pfad von Time-Machine-Backups aus (haftend, folgt dem Pfad).

```bash
sudo tmutil addexclusion ~/VMs
```

`tmutil addexclusion -p <path>` — Schließt einen festen Pfad aus (folgt nicht, wenn er umbenannt wird).

```bash
sudo tmutil addexclusion -p /usr/local/var/mysql
```

`tmutil removeexclusion <path>` — Entfernt einen Ausschluss.

```bash
sudo tmutil removeexclusion ~/VMs
```

`tmutil isexcluded <path>` — Prüft, ob ein Pfad von Backups ausgeschlossen ist.

```bash
tmutil isexcluded ~/VMs
```

## Backup-Ziele

`tmutil setdestination <path>` — Legt das Backup-Ziel fest (ersetzt das bestehende).

```bash
sudo tmutil setdestination /Volumes/BackupDrive
```

`tmutil setdestination -a <path>` — Fügt ein zusätzliches Backup-Ziel hinzu.

```bash
sudo tmutil setdestination -a /Volumes/SecondBackup
```

`tmutil removedestination <id>` — Entfernt ein Backup-Ziel anhand seiner ID.

```bash
sudo tmutil removedestination XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
```

## Wiederherstellen & Löschen

`tmutil restore <src> <dest>` — Stellt eine Datei oder ein Verzeichnis aus einem Backup wieder her.

```bash
sudo tmutil restore '/Volumes/Backup/2026-03-19/Users/me/file.txt' ~/file.txt
```

`tmutil delete <backup-path>` — Löscht einen bestimmten Backup-Snapshot.

```bash
sudo tmutil delete /Volumes/Backup/Backups.backupdb/Mac/2026-03-01-120000
```

`tmutil calculatedrift <backup-path>` — Zeigt die zwischen Backups geänderte Datenmenge.

```bash
tmutil calculatedrift /Volumes/Backup/Backups.backupdb/Mac
```

`tmutil compare <backup1> <backup2>` — Vergleicht zwei Backups oder ein Backup mit der aktuellen Festplatte.

```bash
tmutil compare /Volumes/Backup/Backups.backupdb/Mac/2026-03-18 /Volumes/Backup/Backups.backupdb/Mac/2026-03-19
```

<!-- PROSE:outro -->
## Fazit

tmutil gibt dir die volle Kontrolle über Time Machine – gerade in Skripten und auf entfernten Macs ist das Gold wert. Sei dir aber bewusst, dass einige Unterbefehle unwiderruflich sind: `delete` und `deletelocalsnapshots` entfernen Backups beziehungsweise Snapshots endgültig, und viele Operationen verlangen `sudo`. Prüfe Ziel und Pfad daher immer genau, bevor du etwas löschst oder ein Ziel neu setzt – ein vertippter Pfad kann das falsche Backup treffen. Für den Alltag reichen meist `startbackup`, `status` und `listbackups`; die löschenden Befehle hebst du dir für bewusste Aufräumaktionen auf.

## Weiterführende Links

- [Time Machine zum Sichern deines Mac verwenden](https://support.apple.com/de-de/HT201250) – offizielle Apple-Anleitung zu Time Machine
- [tmutil(8) – man-Page](https://ss64.com/mac/tmutil.html) – vollständige Referenz aller Unterbefehle (englisch)
<!-- PROSE:outro:end -->

## Verwandte Kommandos

- [caffeinate](https://www.jpkc.com/db/cheatsheets/macos/caffeinate/) – verhindert, dass der Mac in den Ruhezustand wechselt
- [defaults](https://www.jpkc.com/db/cheatsheets/macos/defaults/) – liest und schreibt macOS-Voreinstellungen (Property Lists)
- [diskutil](https://www.jpkc.com/db/cheatsheets/macos/diskutil/) – verwaltet Festplatten, Volumes und Partitionen