Zurück zum Blog

tmux Anleitung: Programme nach dem SSH-Logout weiterlaufen lassen

tmux Anleitung: Programme nach dem SSH-Logout weiterlaufen lassen, Sitzungen trennen und fortsetzen, Panes, Scrollen, .tmux.conf und typische Fehler.

Nodesty-Team9 Min. LesezeitServer
Der Schriftzug tmux mit Sitzungen, Fenstern und Panes auf dunklem Nodesty-Hintergrund

Mit dieser tmux Anleitung reißt eine abgebrochene SSH-Verbindung Ihre Arbeit nicht mehr mit. tmux lässt Ihre Programme auf dem Server weiterlaufen, nachdem Sie das Terminal geschlossen haben, bringt Sie Stunden oder Tage später an dieselbe Stelle zurück und bietet mehrere Fenster und Panes in einer einzigen Verbindung.

In dieser Anleitung behandeln wir, warum Programme beim Schließen von SSH stoppen, die Installation von tmux, das Modell aus Sitzungen, Fenstern und Panes, die Grundbefehle, das Scrollen, eine kleine Konfigurationsdatei, ein Gameserver-Beispiel, den Vergleich mit screen, nohup und systemd, eine Tabelle der Tastenkürzel und die häufigsten Fehler.

Warum Programme beim Schließen von SSH stoppen

Wenn Ihre SSH-Verbindung endet, verschwindet das Terminal, an dem Ihre Shell hing. Das System sendet der Shell ein Hangup-Signal (SIGHUP), die Shell gibt es an die von ihr gestarteten Programme weiter, und die meisten Programme beenden sich daraufhin. Deshalb stoppt ein Gameserver, ein langer Kopiervorgang oder ein Upgrade in dem Moment, in dem die Verbindung abreißt; die üblichen Ursachen für Abbrüche finden Sie in unserer Anleitung SSH Verbindungsfehler.

tmux löst das mit einem Serverprozess, der auf dem Rechner läuft und nicht an Ihre SSH-Verbindung gebunden ist. Ihre Programme laufen in diesem tmux-Prozess; was Sie sehen, ist nur ein Client, der sich damit verbindet. Endet die Verbindung, verschwindet nur der Client.

tmux installieren

sudo apt install tmux     # Ubuntu / Debian
sudo dnf install tmux     # AlmaLinux / Rocky Linux
tmux -V

Installieren Sie tmux auf dem Server, nicht auf Ihrem eigenen Rechner: Die Sitzung muss dort liegen, wo das Programm läuft.

Sitzungen, Fenster und Panes

  • Sitzung (Session): Ein Arbeitsbereich, der im Hintergrund weiterläuft. Sie lösen sich von ihr und verbinden sich später wieder. Geben Sie jeder Aufgabe eine eigene benannte Sitzung, etwa minecraft oder backup.
  • Fenster (Window): Ein Terminal in voller Größe innerhalb einer Sitzung, vergleichbar mit einem Browser-Tab. Eine Sitzung kann viele Fenster haben.
  • Pane: Ein Fenster lässt sich in Panes teilen, sodass Sie mehrere Terminals nebeneinander sehen.

Die grüne Statuszeile am unteren Rand zeigt links den Namen der Sitzung und daneben die Liste der Fenster; das aktuelle Fenster ist mit * markiert.

Die Grundlagen: starten, lösen, zurückkehren

Jedes tmux-Tastenkürzel beginnt mit dem Präfix Strg + B: drücken, loslassen, dann die nächste Taste drücken. Groß- und Kleinschreibung zählt, d und D bewirken Verschiedenes.

tmux new -s arbeit           # startet eine Sitzung namens arbeit
tmux ls                      # listet die Sitzungen auf
tmux attach -t arbeit        # kehrt in die Sitzung zurück
tmux kill-session -t arbeit  # beendet die Sitzung samt Inhalt

Starten Sie eine Sitzung, führen Sie Ihren Befehl aus und drücken Sie Strg + B, dann d, um sich zu lösen. Sie sind wieder in Ihrer normalen Shell und können die SSH-Verbindung schließen; der Befehl läuft weiter. Reißt die Verbindung von selbst ab, wird die Sitzung automatisch gelöst und das Programm läuft ebenfalls weiter. Nach der erneuten Anmeldung zeigt tmux ls, was läuft:

arbeit: 1 windows (created Sun Nov 15 10:12:03 2026)

Lösen ist nicht dasselbe wie Beenden. Wenn Sie exit eingeben oder Strg + D drücken, wird die Shell geschlossen, und mit der letzten Shell einer Sitzung endet die Sitzung. tmux new -A -s arbeit verbindet sich mit der Sitzung, falls sie existiert, und legt sie andernfalls an; ein Befehl genügt also für beide Fälle.

Mit Fenstern arbeiten

Mit Strg + B, dann c öffnen Sie ein neues Fenster. Sie wechseln mit n (nächstes), p (vorheriges) oder einer Ziffer von 0 bis 9; w zeigt eine Liste zur Auswahl. Mit , benennen Sie das aktuelle Fenster um, damit in der Statuszeile zum Beispiel logs statt bash steht. & schließt das Fenster nach einer Rückfrage.

Eine typische Aufteilung: ein Fenster für das Programm selbst, eines für die Logdateien und eines für htop. Weitere Alltagsbefehle finden Sie in unserer Anleitung Linux Befehle.

Ein Fenster in Panes teilen

Strg + B, dann % teilt das aktuelle Pane in eine linke und eine rechte Hälfte; " teilt es in eine obere und eine untere. Zwischen den Panes wechseln Sie mit Strg + B und einer Pfeiltaste. z vergrößert das aktuelle Pane auf das ganze Fenster, dieselbe Taste stellt die Aufteilung wieder her. x schließt das Pane nach einer Rückfrage; exit im Pane bewirkt dasselbe. Um die Größe zu ändern, drücken Sie Strg + B und danach bei gehaltener Strg-Taste eine Pfeiltaste.

Scrollen und Kopiermodus

In tmux zeigt die Bildlaufleiste Ihres Terminals keine ältere Ausgabe. Nutzen Sie stattdessen den Kopiermodus: Drücken Sie Strg + B, dann [, bewegen Sie sich mit den Pfeiltasten oder Bild auf und Bild ab und kehren Sie mit q zurück. Auf einer deutschen Tastatur geben Sie [ mit AltGr + 8 ein. Strg + B, dann Bild auf startet den Kopiermodus und scrollt in einem Schritt eine Seite nach oben. Text, den Sie im Kopiermodus kopiert haben, fügen Sie mit Strg + B, dann ] ein.

Eine kleine ~/.tmux.conf

tmux funktioniert ganz ohne Konfiguration. Diese wenigen Zeilen in ~/.tmux.conf machen den Alltag angenehmer:

set -g mouse on
set -g history-limit 20000
set -g base-index 1
setw -g pane-base-index 1
  • mouse on: Sie scrollen mit dem Mausrad, wählen ein Pane per Klick und ziehen an den Rändern der Panes. Um bei aktivierter Maus Text mit der Auswahl Ihres Terminals zu markieren, halten Sie in den meisten Terminals die Umschalt-Taste gedrückt.
  • history-limit: Legt fest, wie viele Zeilen jedes Pane zurückbehält; der Standard ist 2.000. Der Wert gilt für Panes, die nach der Änderung entstehen.
  • base-index und pane-base-index: Nummerieren Fenster und Panes ab 1 statt ab 0, was besser zur Ziffernreihe der Tastatur passt.

Die Datei wird gelesen, wenn der tmux-Serverprozess startet. So wenden Sie sie auf ein bereits laufendes tmux an:

tmux source-file ~/.tmux.conf

Beispiel: ein Gameserver in tmux

Starten Sie eine Sitzung, wechseln Sie in den Serverordner und starten Sie den Server. Das Beispiel nutzt einen Minecraft-Server; die Installation beschreiben wir in unserer Anleitung Minecraft Server erstellen.

tmux new -s minecraft
cd /opt/minecraft
java -Xms2G -Xmx2G -jar server.jar nogui

Sobald der Server läuft, lösen Sie sich mit Strg + B, dann d und schließen SSH. Später melden Sie sich an und kehren in die laufende Konsole zurück:

tmux attach -t minecraft

Mit stop in der Konsole fahren Sie den Server sauber herunter. Sie können auch einen Befehl senden oder die Konsole lesen, ohne sich zu verbinden; das ist in Skripten nützlich:

tmux send-keys -t minecraft 'say Neustart in 5 Minuten' Enter
tmux capture-pane -p -t minecraft

Sie können den Befehl auch direkt übergeben, wie unsere Anleitung Palworld Server erstellen es mit tmux new -s palworld ./PalServer.sh tut. Dann schließt sich das Fenster allerdings, sobald das Programm endet, und eine Fehlermeldung verschwindet mit ihm. Solange Sie noch testen, starten Sie zuerst eine Shell und führen den Befehl darin aus.

Dasselbe Muster eignet sich für jede lange Aufgabe: ein Release-Upgrade (Ubuntu Upgrade), eine große Übertragung (rsync-Anleitung) oder einen Datenbankimport.

tmux, screen, nohup und systemd im Vergleich

WerkzeugÜbersteht SSH-EndeZurück in die KonsoleNeustart nach AbsturzStart beim Booten
nohup befehl &JaNein, Ausgabe landet in einer DateiNeinNein
screenJaJaNeinNein
tmuxJaJaNeinNein
systemd-DienstJaNein, Logs über journalctlJa, mit Restart=Ja, mit enable

nohup genügt für einen einmaligen Befehl ohne Eingaben; die Ausgabe landet in nohup.out. screen erledigt im Kern dieselbe Aufgabe wie tmux; nutzen Sie, was Sie kennen. tmux ist kein Prozessmanager: Es startet ein abgestürztes Programm nicht neu, und nach einem Neustart des Servers sind die Sitzungen verschwunden. Für alles, was rund um die Uhr laufen muss, etwa einen Bot, eine API oder einen produktiven Gameserver, legen Sie einen Dienst an, wie in unserer Anleitung systemd-Service erstellen beschrieben. tmux nutzen Sie für interaktive Konsolen, Tests und lange einmalige Aufgaben.

Tastenkürzel im Überblick

Drücken Sie zuerst Strg + B, dann die Taste:

TasteWirkung
dVon der Sitzung lösen
sSitzungen auflisten und wechseln
$Sitzung umbenennen
cNeues Fenster
n / pNächstes / vorheriges Fenster
0–9Zum Fenster mit dieser Nummer wechseln
wFenster auflisten
,Fenster umbenennen
&Fenster schließen
%In linkes und rechtes Pane teilen
"In oberes und unteres Pane teilen
PfeiltastenZum Pane in dieser Richtung wechseln
zPane vergrößern, erneut drücken stellt wieder her
xPane schließen
[Kopiermodus zum Scrollen, q beendet ihn
?Alle Tastenkürzel anzeigen

Häufige Fehler

  • no sessions oder no server running on ...: Es gibt keine Sitzung, mit der Sie sich verbinden könnten. Sie wurde nie angelegt, sie endete mit ihrer letzten Shell oder der Server wurde neu gestartet. Sitzungen gehören außerdem dem Benutzer, der sie gestartet hat: Eine als root gestartete Sitzung sieht ein anderer Benutzer nicht, und umgekehrt.
  • can't find session: name: Der Name stimmt nicht. Prüfen Sie ihn mit tmux ls.
  • duplicate session: name: Eine Sitzung mit diesem Namen existiert bereits. Verbinden Sie sich mit tmux attach -t name oder nutzen Sie tmux new -A -s name.
  • sessions should be nested with care, unset $TMUX to force: Sie haben tmux new oder tmux attach innerhalb von tmux ausgeführt. Wechseln Sie stattdessen mit Strg + B, dann s die Sitzung oder legen Sie mit tmux new -d -s name eine zweite im Hintergrund an. Löschen Sie $TMUX nicht; ein tmux im tmux macht die Tastenkürzel unübersichtlich.
  • open terminal failed: missing or unsuitable terminal: xterm-kitty: Der Server kennt den TERM-Wert Ihres Terminals nicht, was bei neueren Terminalprogrammen häufig vorkommt. Starten Sie tmux mit TERM=xterm-256color tmux attach -t name.
  • open terminal failed: not a terminal: tmux wurde ohne Terminal gestartet, etwa mit ssh host tmux attach. Nutzen Sie ssh -t benutzer@host tmux attach -t name; in Skripten und Cronjobs starten Sie Sitzungen mit tmux new -d.
  • Die Sitzung wirkt klein oder ist noch als (attached) markiert: Eine alte Verbindung hängt noch an der Sitzung. tmux attach -d -t name verbindet Sie und löst die anderen.

tmux auf Nodesty-Servern

Die Nodesty-Pakete AMD Ryzen 9 9950X vServer und AMD EPYC 7763 vServer kommen mit NVMe-Speicher und vollem Root-Zugriff; so installieren Sie tmux und lassen Gameserver, Upgrades und lange Übertragungen weiterlaufen, nachdem Sie Ihr Terminal geschlossen haben. Bei den vServer-Paketen sind tägliche Backups kostenlos und werden 7 Tage aufbewahrt.

Häufig gestellte Fragen

Wofür wird tmux verwendet?

tmux ist ein Terminal-Multiplexer. Er hält Ihre Shell und die darin laufenden Programme auf dem Server am Leben, auch wenn Ihre SSH-Verbindung endet, und lässt Sie später an dieselbe Stelle zurückkehren. Außerdem können Sie in einer einzigen SSH-Verbindung mehrere Fenster öffnen und den Bildschirm in Panes teilen.

Wie verlasse ich tmux, ohne mein Programm zu beenden?

Drücken Sie Strg + B, lassen Sie los und drücken Sie dann d. Damit lösen Sie sich von der Sitzung, und das Programm läuft im Hintergrund weiter. Wenn Sie stattdessen exit eingeben oder Strg + D drücken, wird die Shell geschlossen; mit der letzten Shell endet auch die Sitzung.

Übersteht eine tmux-Sitzung einen Neustart des Servers?

Nein. tmux-Sitzungen liegen im Arbeitsspeicher; ein Neustart oder Herunterfahren beendet alle Sitzungen samt den Programmen darin. Soll ein Programm nach einem Neustart von selbst wieder starten, betreiben Sie es als systemd-Dienst.

Soll mein Gameserver in tmux oder als systemd-Dienst laufen?

tmux eignet sich für den ersten Start, für Tests und für Server, in deren Konsole Sie Befehle eingeben möchten. Es startet einen abgestürzten Server nicht neu und startet beim Booten nichts von selbst. Für einen Server, der rund um die Uhr erreichbar sein muss, ist ein systemd-Dienst die zuverlässigere Wahl.

Was ist der Unterschied zwischen tmux und screen?

Beide lassen Programme nach dem Trennen der Verbindung weiterlaufen und erlauben es, später zurückzukehren. screen ist älter und auf vielen Systemen noch vorhanden; tmux wird aktiver weiterentwickelt und macht Fenster, Panes und die Konfiguration einfacher. Wenn Sie eines der beiden bereits kennen, müssen Sie nicht wechseln.

Wie scrolle ich in tmux nach oben?

Drücken Sie Strg + B und danach die öffnende eckige Klammer, um den Kopiermodus zu starten, scrollen Sie mit den Pfeiltasten oder Bild auf und Bild ab und verlassen Sie den Modus mit q. Wenn Sie set -g mouse on in Ihre Datei ~/.tmux.conf eintragen, können Sie auch mit dem Mausrad scrollen.

Nodesty

Über den Autor

Nodesty-Team · Infrastruktur und Support

Das Nodesty-Team betreibt unsere Server, unser Netzwerk und unseren DDoS-Schutz im Alltag und beantwortet Support-Anfragen rund um die Uhr. Diese Ratgeber entstehen aus dieser Arbeit.

Verwandte Artikel

Starte deinen Server jetzt.

Erstellen, wachsen und skalieren Sie Ihre Projekte grenzenlos auf der Premium-Infrastruktur von Nodesty.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································