--- /dev/null
+[[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
+#Using notmuch remotely#
+
+##Why?##
+It is hard to keep nomuch tags in sync across multiple instances of
+notmuch, on multiple computers. Though you can do this with "notmuch
+dump" and "notmuch restore", it is often preferable to be able to use
+notmuch on a remote computer as if it were present on a local
+computer.
+
+The following guidelines show how I have accomplished this. It isn't
+perfect, but it works pretty well, and allows me to access notmuch on
+my home computer, using only an emacs client on my netbook or work
+computer, a trivial shell script, a few settings in my .emacs, and a
+couple of common unix utilities (ssh and dtach).
+
+##What you will need##
+You will need to have the following items in place:
+
+1. a working notmuch on one computer (let's call that computer
+"server").
+
+2. a working notmuch emacs interface on another computer (let's call
+that computer "client")
+
+3. `ssh` and `dtach` on your client computer. (TODO: Make dtach
+optional, or allow screen or tmux to be used instead.
+[[Here|remotewrapper]] is a version that does not require dtach.)
+
+4. password-free login (public key authentication) from client to
+server. [Here](http://www.debian-administration.org/articles/152) is a
+good page on how to set it up.
+
+5. a reasonably fast connection. (This isn't really *neccessary*, but
+if your connection is too slow, this won't be very pleasant to use,
+and certainly won't seem transparent.)
+
+
+##Write a wrapper shell script##
+
+Now we will need to write a simple shell script that does two things:
+
+1. replaces the call to the notmuch binary with a call to notmuch
+over ssh.
+
+2. sets up a running, detached, ssh connection to the server, so that
+future calls can reuse the socket.
+
+ #!/usr/bin/env bash
+
+ SSH_BIN="ssh"
+ USER="example_user"
+ SSH_HOST="example.com"
+ SOCKET_DIR="/tmp/notmuch_$(id -u)"
+ SSH_SOCKET="${SOCKET_DIR}/ssh.socket"
+ NOTMUCH_REMOTE_BIN="notmuch"
+ DTACH="/usr/bin/dtach"
+ DTACH_SOCKET="${SOCKET_DIR}/dtach.socket"
+
+ check_for_socket_dir ()
+ {
+ [ -d "${SOCKET_DIR}" ]
+ }
+
+ check_socket_dir_owner_and_perm ()
+ {
+ [ "$(stat -c %U ${SOCKET_DIR})" = "$(whoami)" ] &&
+ [ "$(stat -c %a ${SOCKET_DIR})" = "700" ]
+ }
+
+ create_socket_dir ()
+ {
+ mkdir "${SOCKET_DIR}"
+ chmod 700 "${SOCKET_DIR}"
+ }
+
+ check_for_socket ()
+ {
+ [ -S "${SSH_SOCKET}" ]
+ }
+
+ start_socket ()
+ {
+ dtach_command="${DTACH} -n ${DTACH_SOCKET} ${SSH_BIN} -M -S ${SSH_SOCKET} ${USER}@${SSH_HOST}"
+ command -v ${DTACH} &>/dev/null && ${dtach_command}
+ }
+
+ notmuch_run ()
+ {
+ if check_for_socket_dir; then
+ if check_socket_dir_owner_and_perm; then
+ if ! check_for_socket; then
+ start_socket
+ fi
+ else echo "Wrong permissions of ${SOCKET_DIR}" >&2
+ exit 1
+ fi
+ elif create_socket_dir; then
+ start_socket
+ else
+ exit 1
+ fi
+ printf -v ARGS "%q " "$@"
+ $SSH_BIN -S $SSH_SOCKET $USER@$SSH_HOST $NOTMUCH_REMOTE_BIN ${ARGS}
+ }
+
+ notmuch_run "$@"
+
+Save this to a file, "remote-notmuch.sh", in your path.
+
+Now you can run "remote-notmuch.sh new". You can call the script
+anything you like. I actually have $HOME/bin/notmuch linked to that
+script, so I can have transparent
+usage.
+
+##Configure your emacs client##
+
+The only thing you need to do is tell your emacs client to use the
+script. Add the following to your .emacs (this is on your client
+machine):
+
+ (setq notmuch-command "/path/to/your/remote-notmuch.sh")
+
+##Problems##
+Some things probably won't work perfectly, and there might be some unexpected
+mismatches between normal usage and this sort of usage. If you're
+using this approach and run into any problems, please feel free to
+list them here. And, of course, if you improve on any of these
+approaches, please do edit this page and let people know!
[[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
-#Using notmuch remotely#
+# Using notmuch remotely #
-##Why?##
-It is hard to keep nomuch tags in sync across multiple instances of
+## Why? ##
+
+It is hard to keep notmuch tags in sync across multiple instances of
notmuch, on multiple computers. Though you can do this with "notmuch
dump" and "notmuch restore", it is often preferable to be able to use
-notmuch on a remote computer as if it were present on a local
-computer.
+notmuch on a remote computer as if it were present on a local computer.
-The following guidelines show how I have accomplished this. It isn't
-perfect, but it works pretty well, and allows me to access notmuch on
-my home computer, using only an emacs client on my netbook or work
-computer, a trivial shell script, a few settings in my .emacs, and a
-couple of common unix utilities (ssh and dtach).
+The following guidelines show how to accomplished this. It isn't
+perfect, but it works pretty well, and allows one to access notmuch on
+one computer, using only an Emacs client, a trivial shell script, and
+some Emacs and ssh settings on another computer.
-##What you will need##
-You will need to have the following items in place:
+## What you will need ##
-1. a working notmuch on one computer (let's call that computer
-"server").
+You will need to have the following items in place:
-2. a working notmuch emacs interface on another computer (let's call
-that computer "client")
+1. a working notmuch and `sshd` on one computer (let's call that
+computer "server").
-3. `ssh` and `dtach` on your client computer. (TODO: Make dtach
-optional, or allow screen or tmux to be used instead.
-[[Here|remotewrapper]] is a version that does not require dtach.)
+2. a working notmuch emacs interface (of the same version as on the
+server), `bash`, and `ssh` on another computer (let's call that computer
+"client")
-4. password-free login (public key authentication) from client to
+3. password-free login (public key authentication) from client to
server. [Here](http://www.debian-administration.org/articles/152) is a
good page on how to set it up.
-5. a reasonably fast connection. (This isn't really *neccessary*, but
-if your connection is too slow, this won't be very pleasant to use,
-and certainly won't seem transparent.)
-
-
-##Write a wrapper shell script##
-
-Now we will need to write a simple shell script that does two things:
-
-1. replaces the call to the notmuch binary with a call to notmuch
-over ssh.
-
-2. sets up a running, detached, ssh connection to the server, so that
-future calls can reuse the socket.
-
- #!/usr/bin/env bash
-
- SSH_BIN="ssh"
- USER="example_user"
- SSH_HOST="example.com"
- SOCKET_DIR="/tmp/notmuch_$(id -u)"
- SSH_SOCKET="${SOCKET_DIR}/ssh.socket"
- NOTMUCH_REMOTE_BIN="notmuch"
- DTACH="/usr/bin/dtach"
- DTACH_SOCKET="${SOCKET_DIR}/dtach.socket"
-
- check_for_socket_dir ()
- {
- [ -d "${SOCKET_DIR}" ]
- }
-
- check_socket_dir_owner_and_perm ()
- {
- [ "$(stat -c %U ${SOCKET_DIR})" = "$(whoami)" ] &&
- [ "$(stat -c %a ${SOCKET_DIR})" = "700" ]
- }
-
- create_socket_dir ()
- {
- mkdir "${SOCKET_DIR}"
- chmod 700 "${SOCKET_DIR}"
- }
-
- check_for_socket ()
- {
- [ -S "${SSH_SOCKET}" ]
- }
-
- start_socket ()
- {
- dtach_command="${DTACH} -n ${DTACH_SOCKET} ${SSH_BIN} -M -S ${SSH_SOCKET} ${USER}@${SSH_HOST}"
- command -v ${DTACH} &>/dev/null && ${dtach_command}
- }
-
- notmuch_run ()
- {
- if check_for_socket_dir; then
- if check_socket_dir_owner_and_perm; then
- if ! check_for_socket; then
- start_socket
- fi
- else echo "Wrong permissions of ${SOCKET_DIR}" >&2
- exit 1
- fi
- elif create_socket_dir; then
- start_socket
- else
- exit 1
- fi
- printf -v ARGS "%q " "$@"
- $SSH_BIN -S $SSH_SOCKET $USER@$SSH_HOST $NOTMUCH_REMOTE_BIN ${ARGS}
- }
-
- notmuch_run "$@"
-
-Save this to a file, "remote-notmuch.sh", in your path.
-
-Now you can run "remote-notmuch.sh new". You can call the script
-anything you like. I actually have $HOME/bin/notmuch linked to that
-script, so I can have transparent
-usage.
-
-##Configure your emacs client##
-
-The only thing you need to do is tell your emacs client to use the
-script. Add the following to your .emacs (this is on your client
-machine):
+4. a reasonably fast connection. (This isn't really *necessary*, but if
+your connection is too slow, this won't be very pleasant to use, and
+certainly won't seem transparent.)
+
+## Configure `ssh` on the client computer ##
+
+Add this to your `~/.ssh/config`:
+
+ Host notmuch
+ HostName example.com
+ User remoteuser
+ ControlMaster auto
+ ControlPath /home/user/.ssh/%h_%p_%r
+ ControlPersist 15m
+ IdentityFile /home/user/.ssh/example.com.id_rsa
+
+Replace `example.com` with your server. Replace `remoteuser` with the
+username on the server. Replace `/home/user` with your home directory.
+
+The `Control*` options keep the connection open in the background to not
+require authentication every time. The `ControlPersist` option defines
+the connection timeout. These aren't strictly necessary, but reduce
+latency.
+
+The `IdentityFile` option may not be necessary depending on how you set
+up public key authentication. This assumes you set up a separate key;
+set the filename accordingly.
+
+Please refer to `ssh_config(5)` man page for details.
+
+## Set up a wrapper shell script on the client computer ##
+
+Save this to a file, for example `remote-notmuch.sh`, in your `PATH`:
+
+ #!/bin/bash
+ printf -v ARGS "%q " "$@"
+ exec ssh notmuch notmuch ${ARGS}
+
+Now you can run `remote-notmuch.sh new`, or other notmuch commands. You
+can call the script anything you like. (You could also call it `notmuch`
+or symlink `~/bin/notmuch` to it for transparent usage.)
+
+## Configure Emacs on the client computer ##
+
+Add this to your `~/.emacs` to tell the Emacs client to use the wrapper
+script:
(setq notmuch-command "/path/to/your/remote-notmuch.sh")
-##Problems##
-Some things probably won't work perfectly, and there might be some unexpected
-mismatches between normal usage and this sort of usage. If you're
-using this approach and run into any problems, please feel free to
-list them here. And, of course, if you improve on any of these
+If you use Fcc, you may want to do something like this on the client, to
+Bcc mails to yourself:
+
+ (setq notmuch-fcc-dirs nil)
+ (add-hook 'message-header-setup-hook
+ (lambda () (insert (format "Bcc: %s <%s>\n"
+ (notmuch-user-name)
+ (notmuch-user-primary-email))))))
+
+## Problems ##
+
+Some things probably won't work perfectly, and there might be some
+unexpected mismatches between normal usage and this sort of usage. If
+you're using this approach and run into any problems, please feel free
+to list them here. And, of course, if you improve on any of these
approaches, please do edit this page and let people know!
+
+If you have issues, you may want to try the [[old remote usage
+instructions|remoteusage-old]].
projects / obsolete / notmuch-wiki / commitdiff