ruby-sftp-sync

ruby-sftp-sync

sync a directory with your webhoster (no deletion) - perfect for jekyll users with a simple webspace

Push files to a server using sftp (and ssh)

In order to automate my Jekyll workflow, I thought about writing a bash script first. But why not use Ruby instead?

Inspiration was found here, where Matthew Bass (Matthew's GitHub) wrote a nice little article dated 2007. Though its simplicity made it easy to grasp, the script had some flaws. If you used an FTP client for your first upload, and the directories of your project would change or would never be deeper than one level - you are good to go. Yet my project had nested directories and thanks to progress, the gems wouldn't work quite the same as in the old days of 2007.

How to use?

Simply load the script and the config.yml to the root of your application.

Setup your Configuration in config.yml

host_url: 'yourdomain.com'
username: 'xyz'
local_path: './_site'
remote_path: '/httpdocs/public_html'
file_perm: 0o644
dir_perm: 0o755

The following commands are implemented:

  • $ ruby Upload2SFTP.rb upload [--config ./path-to-config.yml]

    uploads new files and directories

  • $ ruby Upload2SFTP.rb clean [--config ./path-to-config.yml]

    deletes all files and subdirectories

  • $ ruby Upload2SFTP.rb reupload [--config ./path-to-config.yml]

    deletes all files and subdirectories and resyncs

  • $ ruby Upload2SFTP.rb remove [--config ./path-to-config.yml]

    deletes all files, subdirectories and root


relies on the following gems, so either run $ bundle or:

# https://github.com/net-ssh
$ gem install net-ssh
$ gem install net-sftp
$ gem install commander

Pull requests are welcome! :octocat:

jekyll logo

Want a Jekyll website built?

Hire a Jekyll developer