Skip to content
CoffeeScript JavaScript
Branch: master
Clone or download
randy3k Merge pull request #49 from jjlorenzo/patch-1
Listen on all interfaces
Latest commit 4099cb0 Oct 6, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Listen on all interfaces Sep 28, 2018
menus add start/stop server Jun 15, 2014
.gitignore init comit Jun 15, 2014 init comit Jun 15, 2014 init comit Jun 15, 2014 cosmatic changes Jan 23, 2018
package.json Prepare 1.3.12 release Jan 23, 2018


Remote Atom is a package for Atom which implements the Textmate's 'rmate' feature for Atom. It transfers files to be edited from remote server using SSH port forward and transfers the files back when they are saved.


Remote Atom can easily be installed using the Atom package manager by going to "Settings > Install" and searching for remote-atom, or by using the command line:

sudo apm install remote-atom

On the remote server, we need to install rmate (this one is the bash version). You don't have to install it if you have been using rmate with TextMate or Sublime Text. It is the same executable for TextMate and Sublime Text. If not, it (the bash version) can be installed by running this script (assume that you have the permission),

curl -o /usr/local/bin/rmate
sudo chmod +x /usr/local/bin/rmate

You can also rename the command to ratom

mv /usr/local/bin/rmate /usr/local/bin/ratom

If your remote system does not have bash (so what else does it have?), there are different versions of rmate to choose from:


Open your Atom application, go to the menu Packages -> Remote Atom, and click Start Server. Your can also launch the server via command palette. The server can also be configured to be launched at startup in the preference.

Then, open an ssh connection to the remote server with remote port forwarded. It can be done by

ssh -R 52698:localhost:52698

After running the server, you can just open the file on the remote system by

rmate test.txt

... or if you renamed it to ratom then ...

ratom test.txt

If everything has been setup correctly, your should be able to see the opening file in Atom.

SSH config

It could be tedious to type -R 52698:localhost:52698 everytime you ssh. To make your life easier, add the following to ~/.ssh/config,

    RemoteForward 52698 localhost:52698
    User user

From now on, you only have to do ssh

Known issues

Since each window of Atom is a separate instance, the tcp server can only be running on one window. Therefore, file will only be opened in the window with the server running. If that window is closed, the server can be restarted by clicking Packages -> Remote Atom -> Start Server.

Maintainer wanted!

This Atom package is no longer maintained. If there are any one who are interested to take charge of it, please file an issue on GitHub issues.


  • writing tests
You can’t perform that action at this time.