GiBUU is hosted by Hepforge, IPPP Durham

Running GiBUU on a Windows System

Currently the recommended way of using GiBUU on a Windows system is via Cygwin.


  1. Download cygwin
  2. Install cygwin. In the package selection, make sure the following packages are being installed:
    • devel/gcc-fortran
    • devel/make
    • devel/subversion
    • base/which
    • archive/libbz2-devel
    • perl/perl
    • net/openssh
  3. After the installation finished, start cygwin.
  4. Create a directory for GiBUU, e.g.:
     cd /cygdrive/c
     mkdir GiBUU
     cd GiBUU
  5. Checkout out the GiBUU code using svn, as explained in download.
  6. Go to the directory "workingCode" (or "release1.x") and type
  7. After make is done, you will find the executable "GiBUU.x" in the "testRun" directory, where you can run GiBUU with the command
    ./GiBUU.x < jobCardName
    Sample jobcards are available in testRun/jobCards, cf. also our FAQ page for more informations.

Alternative checkout via TortoiseSVN / Putty

TortoiseSVN is a nice GUI tool that integrates with the Windows Explorer. It can also be used to checkout the GiBUU code. However, this is currently not recommended, since it can potentially lead to file-permission problems in Cygwin.

For GiBUU developers

You can do the following to check out the code via svn+ssh with Cygwin (using ssh keys to avoid typing passwords all the time).

See TortoiseSVN SSH HowTo or follow the explanation given below:

  1. Install putty on your system
  2. Set up a ssh-key pair to be used with putty.
    • Go via putty, e.g., to tp1 an run "ssh-keygen" by typing
      ssh-keygen -t dsa
      This generates a dsa-keyfile called "" in the directory "~/.ssh".
    • Now execute
      cat ~/.ssh/ >> .ssh/authorized_keys
    • Open in your Windows "PuTTYgen"
    • Choose "conversions" and read in your freshly created private (not public!) dsa key, which is given by the file "~/.ssh/id_dsa". Save the key after conversion as a ".ppk"-file
    • Start putty's pageant (Start->Programme->Putty->Pageant)
    • Load the freshly created .ppk-file into pageant
      • Hint: Add the command "pageant 'path to your ppk.file'" as a link to your Windows-Autostart, such that pageant is started at system start.
  3. Make sure "Pageant" is running and your ssh-key is loaded.
  4. Open "putty" and go to "Session"
    • Enter
      • Host Name =
      • Port = 22
      • Connection type = ssh
    • Now save the session as "putty_hepforge" (Putty->Session->Save Session)
    • Click on putty_hepforge and check whether a putty window opens which connects you directly to the Hepforge server. You should not be asked for your password! If you are still asked for it, please verify step 3! If putty can't connect, please verify hostname and port!
  5. Install tortoise on your system
  6. Download GiBUU to your windows hard drive. Details:
    1. Right click on your Desktop: After installing tortoise a menu item "SVN checkout" should be available.
    2. Left click on "SVN checkout".
    3. Enter in the field "URL of repository"
      to download the code.
    4. Choose checkout directory, e.g.
      • Please take care, that the full path where you store GiBUU does not include any blanks.
      • Especially "C:\Dokumente und Einstellungen\..." is no good, but "C:\GiBUU" is fine!
    5. Click on "ok", and then "yes" to create the checkout directory.
Last modified 15 months ago Last modified on Feb 10, 2016, 11:58:01 PM