Header
  1. tortoise
  2. v313
  3. 1. INSTALLING TORTOISE

1. INSTALLING TORTOISE

Please make sure you untar your downloaded files from command line. After installation, if you receive permission issues when running a command, please change the permissions of the entire folder using chmod command.

1.1. LINUX

  • Download
  • Extract to a folder.
  • In a terminal type the following echo $0
  • after typing echo shell command, if terminal returns tcsh type tcsh ./install_tcsh.tcsh
  • after typing echo shell command, if terminal returns bash type bash ./install_bash.sh OR  bash ./install_bash.bash

If you are installing TORTOISE VER3.1.4 or 3.2, you may follow the above steps or:

  • please then type bash install_TORTOISE.bash

Now, TORTOISE has been added to your path and you can just run any TORTOISE command by typing it in the terminal.

1.2. MAC

  • Extract to a folder. Please make sure that you have downloaded the .tar.gz file and the file is not automatically being zipped by mac while downloading. If so, please click on your browser type on the top left corner, go to preferences, select general and uncheck the box that reads ‘open “safe” files after downloading.
  • In a terminal type the following echo $0
  • after typing echo shell command, if terminal returns tcsh type tcsh ./install_tcsh.tcsh
  • after typing echo shell command, if terminal returns bash type bash ./install_bash.sh  OR  bash ./install_bash.bash 

If you are installing TORTOISE VER3.1.4 or 3.2 you may follow the above steps or:

  • please then type bash install_TORTOISE.bash

Now, TORTOISE has been added to your path and you can just run any TORTOISE command by typing it in the terminal.

1.3. WINDOWS

The support for windows version of TORTOISE has been discontinued. This is because , windows 10 now fully supports Ubuntu subsystem which can be downloaded from windows store. With this installed, in a command line, the users can type bash and be able to use the TORTOISE linux version. Please follow the steps detailed under linux installation above, if using Windows OS.

Note: If TORTOISE is added to your path using the above instructions for the different OS listed, you can run the various executables listed in the upcoming sections by just typing them in the terminal. If TORTOISE is not added to your path, then you will have to go to the folder where the executables exist and run with a ./ before running command of interest.

1.4. TORTOISE GUI

Along with command line feature, there is a TORTOISE GUI available in a separate folder when you download the TORTOISE software onto your selected OS. You will find inside the TORTOISE_GUI folder a executable by name TortoiseGui.py. Please refer to section 12 of this documentation for information on the GUI features.

To run TORTOISE GUI, PYQT5 needs to be installed using instructions below:

In Ubuntu,  type as a sudo user: 

sudo apt-get install python3-pip

In MAC,  with brew installed , type:

brew install pyqt5

With PyQt5 installed, you can run the GUI with :   

python3 TortoiseGui.py

 

Next