<html><head><title>SimpleSSHD</title></head> <body> <p style="float:right;"><img src="icon.png"></p> <h1>SimpleSSHD</h1> <p>SimpleSSHD is an SSH2 server based on dropbear that supports scp, sftp, and rsync. It only supports public-key based authentication (no password/interactive auth). It does not use root, which means it must listen on a port over 1024 (defaults to port 2222).</p> <h2>Quick start</h2> <ul> <li> Install SimpleSSHD. <li> Either: <ul> <li> Go to SimpleSSHD -> Menu (upper right) -> Authorized Keys, and either cut and paste an SSH public key or "Fetch" one via HTTP. <li> OR: Make a directory <tt>/sdcard/ssh</tt>, and put an <tt>authorized_keys</tt> file in that directory. </ul> <li> On any computer which will connect to your Android device, set the port to 2222. With OpenSSH, this can be done by putting these lines in <tt>~/.ssh/config</tt>: <blockquote><pre> Host myphone Port 2222 </pre></blockquote> <li> Launch SimpleSSHD, and in Settings enable "Start on Boot", and manually start it for the first time. <li> You might want to put a <tt>.profile</tt> in <tt>/sdcard/ssh</tt>, too. </ul> <p>Voila! You can use ssh/scp/sftp/rsync to talk to your Android device!</p> <h2>Configuration</h2> <p>There are three directory settings that are important for SimpleSSHD.</p> <p>The first is the path for general dropbear files, which defaults to <tt>/sdcard/ssh</tt>. Most importantly, this is where <tt>authorized_keys</tt> is found. It is also where host keys wind up (they are created on demand), and where temporary files go.</p> <p>Next is the path to the login shell. The default Android shell is <tt>/system/bin/sh</tt>, but you may prefer to use the one that comes with busybox or whatever. If you set it to the su binary (i.e., <tt>/system/xbin/su</tt>), then scp, sftp, and rsync will run as root and should be able to access files outside of the sdcard.</p> <p>A bug in SuperSU interacts with an infelicity in rsync to cause an occasional deadlock. This is a real pain because I use SuperSU+rsync for system-wide backups, which will always eventually trigger the deadlock. To work around this, there is a "Buffer hack" option that should be enabled if you use rsync with SuperSU. It adds a miniscule overhead to rsync, but isn't harmful even if you aren't using SuperSU.</p> <p>Finally, there is the path for the home directory, which also defaults to <tt>/sdcard/ssh</tt>. This is where your ssh session starts out, and is where <tt>.profile</tt> will be found if it is present.</p> <p>There is also a place where you can put additional commandline options for dropbear server. The options which are hardcoded are: <tt>-R -F -p :portno</tt>. You can use <tt>\</tt> or <tt>"</tt> to escape characters in this commandline.</p> <h2>Change Log</h2> <ul> <li> <b>2014/12/22 Version 1.0:</b> Initial public release. <li> <b>2014/12/29 Version 1.1:</b> Works with Lollipop now. <li> <b>2015/01/18 Version 1.2:</b> Displays the IP address it's listening on. <li> <b>2015/06/21 Version 1.3:</b> Hack to make rsync work with SuperSU. <li> <b>2015/11/23 Version 1.4:</b> Don't abort if IP address lookup fails, and make proper "About" menu. <li> <b>2016/06/11 Version 1.5:</b> SuperSU+rsync hack now limits the buffer size to 1MB. <li> <b>2016/06/12 Version 1.6:</b> Fix typo that broke scp/sftp/rsync in version 1.5. <li> <b>2016/06/19 Version 1.7:</b> Don't clear environment variables (so you can use <tt>am</tt> or <tt>pm</tt> more easily). Add "Authorized Keys" menu option to help maintain the <tt>authorized_keys</tt> file. </ul> <h2>About</h2> <p>SimpleSSHD is built using parts from open source projects: <a href="https://matt.ucc.asn.au/dropbear/dropbear.html">Dropbear SSH</a>, <a href="http://www.openssh.com/">openssh</a> (for scp and sftp-server), and <a href="http://rsync.samba.org/">rsync</a>. Those projects in turn are built on other projects. A lot of people's work is represented here, and very little of my own.</p> <p>But if you find bugs/infelicities, it's probably my fault, so email me:<br> <img src="/email.png"></p> <p>To get the source:<br> <blockquote><pre>git clone http://galexander.org/git/simplesshd.git</pre></blockquote></p> </body></html>