Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

remux allows you to run your local project on multiple remote machines in parallel

Project description


rmux allows you to run your local project on multiple remote machines in parallel.

The command names comes from remote-tmux as it allows multiplexing commands on multiple remote machines, synchronized.

The original purpose was to allow testing local changes to a project on other platforms, like running tox on another distribution.


# run df locally
rmux df

# close tmux session

# run df on two remote hosts, syncronized windows
HOSTS="node1 node2" rmux df

# run a script downloaded from the web (installs pip)
rmux -w

If you fail to define the HOSTS variable the tool will default to localhost but it will still use its logic of doing a rsync and running commands using tmux and ssh.

How it works

rmux will detect current project by looking for the .git folder it in current directory or its parents. If it fails to find any .git folder, it will skip the rsync part.

The script will not rsync .gitignored files but it will sync untracked files.

The destination folder on remote machines is ~/.cache/.rmux/<projectname> which will also become default directory.

The remote user is based on host names or your ssh configuration.


pip install rmux

While rmux is currently only a pure bash script, I used pip wheel as a way to distribute it as it cross platform and easy to use. In addition, it allows me to easily upgrade it.

If you prefer you can just download the shell script and add it to your path.

See also

  • tmux - terminal multiplexer
  • tmux-xpanes - auto-window layout for tmux, a current requirement for rmux. Still, it should be possible to avoid using it if you have only one remote host, just make a feature request and I can implement it.
  • direnv - define environment variables specific to current directory. This can be very handy if you want to have different set of HOSTS for each project and avoid mentioning them on the command line.
  • rtox which allows running tox on remote machines this being the original project. With rmux you will no longer need rtox as you can just do rmux tox instead of rtox, the big difference being that the session is not closed automatically and that you can now run on multiple remote hosts instead of just one.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for rmux, version 1.0.6
Filename, size File type Python version Upload date Hashes
Filename, size rmux-1.0.6-py2-none-any.whl (10.4 kB) File type Wheel Python version py2 Upload date Hashes View
Filename, size rmux-1.0.6.tar.gz (456.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page