Iceberg is a set of tools that allow one to handle git repositories directly from a Pharo image. Right now we support only git, but Iceberg is designed to allow other code versioning systems in the future. The final aim of Iceberg is to become the default repository manager for Pharo-core, allowing for smoother and faster integration of contribu…
Smalltalk HTML Shell
Latest commit a39ee7f Aug 13, 2018
Failed to load latest commit information.
BaselineOfIceberg.package Use libgit 1.5.1 Aug 13, 2018
Iceberg-ArchitecturalRules.package Wrap all libgit accesses with exception handling. May 2, 2018
Iceberg-GitCommand.package Saving files into the working copy does automatically add them to the… Dec 14, 2016
Iceberg-Libgit-Filetree.package Working tests Jul 17, 2018
Iceberg-Libgit-Tonel.package Use Path API compatible with Pharo6 and Pharo7 Jun 27, 2018
Iceberg-Libgit.package Fix #965 Aug 10, 2018
Iceberg-Memory.package Fix #932 Aug 2, 2018
Iceberg-Metacello-Integration.package fixes #962 Aug 7, 2018
Iceberg-Pharo6.package Add compatibility methods for Pharo 6.1 May 3, 2018
Iceberg-Plugin-GitHub.package Fix #961 Aug 10, 2018
Iceberg-Plugin-Metacello.package Fix #934 Aug 1, 2018
Iceberg-Plugin-Migration-Tests.package Pass on migration tests Aug 2, 2018
Iceberg-Plugin-Migration.package Tests are passing Jul 17, 2018
Iceberg-Plugin-Pharo.package Move pharo repository bootstrap to Pharo plugin Aug 3, 2018
Iceberg-Plugin.package replace usage of #asIcon with #iconNamed: Jun 5, 2018
Iceberg-Tests-MetacelloIntegration.package Tests are passing Jul 17, 2018
Iceberg-Tests.package Merge 512dca8 Aug 13, 2018
Iceberg-TipUI.package Fix #964 Aug 10, 2018
Iceberg-UI-Tests.package Add tests to enforce positioning of toolbar buttons Jun 28, 2018
Iceberg.package Merge 512dca8 Aug 13, 2018
docs Put docs up to date Jul 7, 2018
scripts Merge 7ca3185 Aug 3, 2018
.filetree gitfiletree repository properties Apr 19, 2016
.project Fix all tests except metacello integration Jun 14, 2018
.properties Fix all tests except metacello integration Jun 14, 2018
.smalltalk.metacellotests.ston Fixing the smalltalkCI to run only the required tests and only once Jul 31, 2018
.smalltalk.ston fixed crs Jun 27, 2018
.travis.yml Remove need of ston file Aug 6, 2018 Add a file pointing to the wiki May 24, 2018
LICENSE Create LICENSE Apr 28, 2018 Update Aug 7, 2018
appveyor.yml add windows build May 14, 2018 Cookbook: Add "Changing Last Commit Author" Jul 15, 2018
iceberg_test.key.enc Adding encrypted key Sep 23, 2016

Git integration for Pharo

Iceberg is a set of tools that allows one to handle git repositories directly from a Pharo image. Right now we only support git, but Iceberg is designed to allow other code versioning systems in the future. The final aim of Iceberg is to become the default repository manager for Pharo-core, allowing for smoother and faster integration of contributions, as well as better branch and version management.

Please be aware that this is still an experimental tool, so you have to be careful. But we already have a few early adopters, so you are invited to try it and provide feedback.

To better understand Iceberg (or even this documentation), I recommend to read the wiki pages which explain (parts of) the Iceberg and Git nomenclature Travis Build Status Appveyor Build status


Q. The Image seems to freeze when doing a clone of a repository.
A. This is because the operation is taking time and Iceberg still does not show feedback properly. You just need to be patient :)

Q. The Image freezes when cloning/commiting and there is nothing I can do to fix it. I used HTTPS as the protocol when doing the clone.
A. There is a known bug around HTTPS and getting the credentials. We will fix this, but while waiting for the fix, you can work around the problem by:

  • Adding your credentials before doing any operation (go to System Settings/Tools/Software Configuration Management/Iceberg/Plain credentials)
  • Just using the SSH protocol instead (but that option is not as easy on Windows).

Q. I installed Iceberg and try to clone a project, but I'm getting the error message "LGit_GIT_ERROR no ssh-agent suitable credentials found".
A. Currently Iceberg SSH support just handles SSH/ssh-agent. You can fix this problem in two ways:

  • In the command line, run this: ssh-add ~/.ssh/id_rsa (macOS users may prefer to execute this: ssh-add -K ~/.ssh/id_rsa)
  • Go to Iceberg settings System Settings/Tools/Software Configuration Management/Iceberg/Use custom SSH keys and add the path to your and id_rsa files there.

Q. I'm on Linux and when I want to commit I get the message "LGit_GIT_ERROR: no error message set by libgit2."
A. Iceberg for Pharo6 on Linux requires a different version of the VM than the one that is provided by default (this will be the default on Pharo7). The easiest way to get this VM is to execute curl | bash.

Q. I'm using a server with a different SSH port and I'm getting a "connection timeout" when I'm trying to clone.
A. You need to use a different URL format than the default (the one that is proposed on most sites). You need a URL that looks like this template: ssh://git@url:port/team/project.git.

Q. I'm using Iceberg on Windows - whilst trying to clone a repository I get the error "LGit_GIT_ERROR: error authenticating: failed connecting agent".
A. Prompting for credentials currently doesn't work on Windows (we can't use ssh-agent). You need to setup authentication using SSH keys. Something like this:

IceCredentialsProvider useCustomSsh: true.
IceCredentialsProvider sshCredentials
	publicKey: 'c:\path\to\ssh\';
	privateKey: 'c:\path\to\ssh\id_rsa'

(Your key should not have a passphrase)

Q. I'm using 2FA on github and when I try to to create a PR from Iceberg, I'm asked a login/passwd. I try to login but it doesn't work. A. There is no support for 2FA in Iceberg for the moment. Please create a personal Access Tokens to replace your password in order to avoid this problem:

Installation (for development)


  • Latest Pharo 6.1+ image.
  • Pharo VM for Pharo 6.1+.

You can get both by downloading it from the Pharo site or in the command line with zeroconf:

wget -O- | bash

Install Iceberg

Since Pharo 6.0, Iceberg is included in the Image, so you probably will need to update rather than install (see below).

Update Iceberg

Pharo 7.0a comes with the latest stable Iceberg version. To update it, just clone Iceberg into your repo and then pull the changes.

For Pharo 6.1

MetacelloPharoPlatform select.
do: [ :each | (each asPackageIfAbsent: [ nil ]) ifNotNil: #removeFromSystem ].
"update icons (iceberg needs some new)"
ThemeIcons current: ThemeIcons loadDefault.
"load iceberg"
Metacello new
  	baseline: 'Iceberg';
  	repository: 'github://pharo-vcs/iceberg:v1.?';
"Re-initialize libgit2"
(Smalltalk at: #LGitLibrary) initialize.

"In some case Pharo/Calypso can have a problem with Obsolete classes. If you encounter this problem just execute this command and retry your action:

Smalltalk compilerClass recompileAll


NOTE: you need to update Iceberg in a NEW image, otherwise there will be obsolete repositories around.

5 minutes tutorial

(the 5 minutes tutorial is no longer valid for this version, we are working on an updated version)

Have a look at the videos []