Skip to content

Latest commit

 

History

History
103 lines (68 loc) · 2.46 KB

INSTALL.md

File metadata and controls

103 lines (68 loc) · 2.46 KB
Raw

INSTALL

Stable on Linux/Unix based systems using make

Note: Make sure Git and cURL are installed.

This should work on Mac OS X, Debian, Ubuntu, Fedora, RedHat, etc.

The easiest way is to use Git for installing:

$ git clone https://github.com/git-ftp/git-ftp.git
$ cd git-ftp
$ git checkout master
$ sudo make install

Updating using git

$ git pull
$ sudo make install

Debian official

See http://packages.qa.debian.org/g/git-ftp.html

Ubuntu official

See https://launchpad.net/ubuntu/+source/git-ftp

Ubuntu PPA (Personal Package Archive) repository

Adding PPA on Ubuntu

$ sudo -s
# add-apt-repository ppa:git-ftp/git-ftp
# aptitude update
# aptitude install git-ftp

Note: Usually updated after every release (tag).

Mac OS X

Warning: git-ftp will not work with OS X 10.8 without GNU grep!

Using homebrew:

# brew install grep
# brew install git
# brew install curl --with-ssl --with-ssh
# brew install git-ftp

Windows

There are at least two ways to install git-ftp on Windows.

  • Using cygwin only
  • Using cygwin and msysgit (recommended)

First install cygwin and install the package 'curl'. If you like to use cygwin only, install package 'git', otherwise install msysgit.

After this, open git bash (or cygwin bash for cygwin only):

$ cd ~
$ git clone https://github.com/git-ftp/git-ftp git-ftp.git
$ cd git-ftp.git && chmod +x git-ftp
$ cp ~/git-ftp.git/git-ftp /bin/git-ftp

Important: Because Windows does not support symbolic links (shortcuts), the above steps will create a copy of the git-ftp script in your /bin/ directory. If you update your git-ftp clone, you will have to repeat the last command.

*Note: the /bin/ directory is a alias, and if you use msysgit this is the same as C:\Program Files (x86)\Git\bin*

Upstream using symlinking

This usually works on Linux based systems, but not on Mac OS X without extending $PATH.

Note: Make sure Git and cURL is installed.

This is a easy way to have more then one git-ftp installed

$ mkdir -p ~/develop/git-ftp.git
$ cd ~/develop/git-ftp.git
$ git clone https://github.com/git-ftp/git-ftp.git .
$ chmod +x git-ftp
$ mkdir ~/bin && cd ~/bin/
$ ln -s ~/develop/git-ftp.git/git-ftp git-ftp.dev

After this you can use 'git ftp.dev' or 'git-ftp.dev'

Update to the latest version is simple as:

$ cd ~/develop/git-ftp.git
$ git pull