Restore tmux session after reboot

Question

Is there any way to save a tmux session? In other words, if I reboot the computer, will I always lose the sessions?

Hibernating is an alternative to leaving your computer running constantly, not rebooting. — chepner, Jun 23 '12 at 17:31
@chepner: There are those days when `*** System restart required ***` — karatedog, Dec 07 '15 at 22:11
@karatedog Yes, so we both agree that hibernation is not a solution to losing your tmux session on reboot. — chepner, Dec 07 '15 at 22:21
@chepner Hibernating is an alternative to some forms of optional rebooting (e.g., turn off and on to conserve power), but not to a required reboot. However, the former is _still_ an alternative to rebooting, no? — SO_fix_the_vote_sorting_bug, Jun 06 '20 at 22:06
Hibernating is not an alternative if you are running a VM in EC2. — jonatan, Apr 19 '21 at 09:17

score 234 · Accepted Answer · edited Jul 01 '18 at 09:51

234

Yes, if you reboot you computer you will lose the sessions. Sessions cannot be saved. But, they can be scripted. What most do in fact is to script some sessions so that you can re-create them. For instance, here's a trivial shell script to create a session:

#!/bin/zsh                                                                                                   

SESSIONNAME="script"
tmux has-session -t $SESSIONNAME &> /dev/null

if [ $? != 0 ] 
 then
    tmux new-session -s $SESSIONNAME -n script -d
    tmux send-keys -t $SESSIONNAME "~/bin/script" C-m 
fi

tmux attach -t $SESSIONNAME

Here's what it does. First, it checks if there's any session already with that name (in this case, the very original name is "script") with tmux has-session. It checks the return code. If there's a ongoing session with that name already, it skips the "if" cycle and go straight to the last line, where it attaches to the session. Otherwise, it creates a session and sends some keys to it (just running a random script for now). Then it exits the "if" block and attaches.

This is a very trivial sample. You can create multiple windows, panes, and the like before you attach.

This will not be the very same thing you asked for, though. If you do any changes to the session, for instance you rename a window and create a new pane in it, if you reboot those changes won't of course be saved.

There are some tools that ease the process of scripting sessions, although I prefer to do things manually (I think it is more versatile). Those tools are Tmuxinator and Teamocil.

My main source of informations was "The Pragmatic Bookshelf" Tmux book.

edited Jul 01 '18 at 09:51

dessert

223
3
6

answered Jun 22 '12 at 08:58

Dakatine

2,748
2
15
13

2

doesn't sound like that will do anything if I want to restore a session with 5 files open. No way to do that? – chovy Jan 25 '13 at 01:38
6

Tmux doesn't know anything about the state of processes you may have had running. You could script having the *same* files open by having the 'send-keys' or 'split-window' command be 'vim file1 file2 file3' or look into your editor's session management (vim -S and the like) – bloy Feb 02 '13 at 14:44
What is the purpose of the `tmux send-keys ...` line? – Dominykas Mostauskis Apr 15 '14 at 13:38
3

@DominykasMostauskis that command _sends_ key presses to the specified session. It's like entering the session, and inputing those very keys from the keyboard. In this case, you send "~/bin/script" followed by Enter. – Dakatine Apr 16 '14 at 15:47
can I have the script do ssh login with username and pass? (I know its not secured just want to know if its possible for systems where i don't care about seurity but still have to have user and pass). – Jas Aug 11 '16 at 05:12
@jas I use key pairs only (passwordless login) and put an alias like this in my .bashrc to SSH to my local VM. Then I just type 'sshlocal' and I'm in: `alias sshlocal='ssh myname@localhost -t "tmux new-session -A -s main"'` – Criminally Inane Mar 26 '19 at 22:49

mislav · Answer 2 · 2014-01-28T13:41:51.863

170

I wrote a simple bash script that persists open tmux sessions, windows and current working directories in each.

Call it like so manually or periodically from cron (because you might forget):

tmux-session save

It will write to ~/.tmux-session. Restore them after reboot like so:

tmux-session restore

I find this much better than a several hundred line long Perl script.

edited Jan 28 '14 at 13:41

answered Jul 04 '13 at 22:37

mislav

2,170
2
15
10

Is this only if you have one tmux session though? – Robert Johnstone May 17 '19 at 09:36
2

This works for mutltiple tmux sessions, but it does not save panes within each window. – SimplyKnownAsG Dec 05 '19 at 17:46
1

Your `tmux-session` script is now in my dotfiles project. Thanks! https://github.com/ElectricRCAircraftGuy/eRCaGuy_dotfiles – Gabriel Staples Mar 22 '20 at 06:48
many thanks for the script @mislav. I saved the script as .zsh and ran `~/.tmux-session.zsh save` in the terminal without errors. Then restarted the computer and then open tmux interminal and ran `~/.tmux-session.zsh restore` and got `width invalid` as a message (with one additional window created in main directory. But the saved session (with 3 windows and 2 panes in each) was not reloaded. Do you have an idea of what could have gone wrong? – ecjb Aug 10 '20 at 12:01
I just changed the extension from `~/.tmux-session.zsh` to `~/.tmux-session` and got a serie of error messages `~/.tmux-session: line x: y: command not found` (where `x` is between 0 and 27 and `y` is between 0 and 2 (for 2 window, one with 2 panes, the other with one pane) – ecjb Aug 10 '20 at 12:07
This was very useful. Thanks! The tmux save format looks to have changed, so I made a minor change to the restore script. – hojusaram Apr 27 '21 at 01:32
@mislav you've had a TODO in that file since 2013. May I recommend https://todoist.com – abbood May 14 '22 at 05:51
It saves the session tabs and directories but that's it. It's a good start though. – Lubo Kanev Jul 14 '22 at 08:02

score 142 · Answer 3 · 2015-02-24T13:18:35.510

142

I wrote a tmux plugin that enables you to save complete tmux environment and restore it later. It strives to be really detailed so that you have a feeling you never quit tmux.

https://github.com/tmux-plugins/tmux-resurrect

Update: now there's a tmux-continuum plugin that performs automatic background saves of tmux environment. Optionally it also *automatically* restores tmux env after computer reboot.

edited Feb 24 '15 at 13:18

answered Aug 30 '14 at 09:16

This plugin is not bad, but it did not restore all my programs. Will read more of your docs and maybe submit an issue on github. – Arne Jul 31 '16 at 12:05
@Arne Depending on the program, this may require program checkpointing. Instead, I would recommend configuring your programs to restore - persistent .vimrc files and cursor positions for vim, etc. - and storing the tmux pane_current_command for programs like man that can be re-opened. Checkpointing is very complicated in my opinion, but worth looking into in any case. – John P Apr 03 '17 at 01:52
4

@bruno-sutic whats the diffrence between your plugin (tmux-resurrect) and tmux-coninuum? – lony Aug 22 '17 at 07:38
Currently I needed to patch continuum like this to make it work https://github.com/tmux-plugins/tmux-continuum/blob/master/docs/continuum_status.md – rofrol Dec 21 '18 at 09:51
I had some problems with bash commands history reloading (when using set -g @resurrect-save-shell-history 'on') and generally with history persistence when switching among terminals in tmux. See [this thread](https://github.com/tmux/tmux/issues/1671) and especially its 5th comment to see a workaround (or hack) I successfully used to overcome this problem – Matej Vargovčík Apr 10 '19 at 07:26
When using my workaround script I also suggest modifying tmux-resurrect plugin by disabling saving of bash history (only loading should be enabled, my script handles history saving after each command). I.e. in current version of tmux-resurrect you should delete lines 299-301 `if save_shell_history_option_on; then ; dump_shell_history ; fi` in tmux-resurrect/scripts/save.sh. The history works without modifying the plugin too but the history files get large and unclean after several tmux environment saves (and can cause performance issues because my script reloads history after each command). – Matej Vargovčík Apr 10 '19 at 08:31
Looks good. Thanks! – Hike Nalbandyan Jul 14 '21 at 07:04

score 12 · Answer 4 · answered Jun 26 '14 at 17:40

12

tmuxinator is a tool written in Ruby, that could be used to create and manage tmux sessions with ease. It could be used to create a project, which could later be instantiated as as tmux session.

answered Jun 26 '14 at 17:40

Praveen Kumar

331
3
5

score 5 · Answer 5 · edited May 29 '21 at 08:12

5

Consider this partial solution found here

The author creates a function that saves the history of the tmux session in order to persist the state of the tmux session post a server reboot.

edited May 29 '21 at 08:12

Paul

766
1
6
22

answered Feb 02 '13 at 21:54

greg

59
1
1

25

Could you please post what they say? Links can rot. – cpast Feb 02 '13 at 22:30
1

@cpast: This is true, but comments can also rot. Best to give both :) – danielpops Apr 21 '16 at 16:44
7

@greg Your link returns 404 – rofrol Dec 21 '18 at 09:50
2

Here's a related github link from that author: https://github.com/edsantiago/tmux-session – zeroimpl Jun 06 '20 at 02:06

score 2 · Answer 6 · answered May 03 '19 at 08:24

I successfully use https://github.com/jimeh/tmuxifier for recreating sessions. This can be installed without ruby, just using git.

Samples are pretty self explanatory, e.g.: https://github.com/jimeh/tmuxifier/blob/master/examples/example.session.sh

Restore tmux session after reboot

6 Answers6

Linked