Posted by: Josh | May 25, 2010

Introducing Hg-PHP, a web Mercurial repository manager

For those that have successfully deployed Mercurial to shared hosting, Hg-PHP Mercurial Repository Manager adds a web interface to manage the hosted repositories. For this first release (v1.0.20100516), features include:

  • create new and delete existing repositories (modifies to hgweb.config)
  • update individual repository settings, controlled available config options (modifies hgrc)
  • integrated changeset, graph and file browser via original Mercurial web front-end
  • overwrite protection (optimistic locking prevents accidental change cancellation when another user makes a change)
  • theme mimicry (manager skinnable with the same stylesheet as available Mercurial web styles)
  • basic authentication – filter repository-authenticated users by username

Installation is simple when performed in addition to my previous Mercurial shared server installation guide.

  1. Install Mercurial through this simple setup guide and ensure it is functional.
  2. Download the latest release of Hg-PHP.
  3. Extract and upload to the web server. If correct, the ‘admin’, ‘python’ and ‘cgi-bin’ folders should be in the same directory.
  4. Configure the application to finish the installation, modifying the files in /admin/application/config/:
    1. .htaccess: It might be appearing as hidden in the / directory, it needs your htpasswd file location. You’ll see an “Internal Server Error” if this isn’t configured right.
    2. config.php: base_url with the path to /admin on the web server
    3. hgphp.php: repositories_abs_dir with the absolute file path to your Hg repositories folder, hgrc_default_arr/paths/default with the URL of the Mercurial server. You may also add to hgrc_default_arr or set an alternate theme_layout. Relative directories are relative to /admin/index.php.
    4. mantis_auth.php: currently does not use Mantis Bug Tracker session authentication, but you’ll need to modify administrators to include the HTTP basic authenticated users that are permitted full access to the repository manager.
  5. Ensure /admin/lock and /cgi-bin are writable by the web server.
  6. Visit your repository manager by viewing the /admin path.

*Note: an error when accessing /admin like “Mercurial repository not found. The specified repository “500.shtml” is unknown, sorry” is most likely caused when /admin/index.php has write & execute privileges for someone other than the file owner. Change these permissions to fix this error.

Your feedback here and issues filed at BitBucket are much appreciated!

**Edit: This project is being renamed to phpHgAdmin… bigger update coming soon.


  1. […] of Mercurial, serving repositories with it’s web interface (basic installation and setup instructions […]

  2. Thanks for the useful information 🙂

  3. […] Mercurial; apparently a lot of folks are heading the Hg way. Think I might try it out myself; this Mercurial/PHP web interface looks pretty interesting. I've been wanting to get a nice repository solution setup for my […]

  4. Can I create a FreeBSD port for this ? Would you be willing to provide tarballs etc.. for such?

  5. Chao. Me encanta como has planteado el contenido. ¿Me
    serias tan amable de otorgar bastante mas documentacion de el contenido?
    Estoy muuy con interes en este tema. Enhorabuena Y Gracias.

  6. Me agrada tu Webblog. Me da laa impresion que has desarrollado la
    datos de tal manera bastante atractiva. Te dejo directamente en marcadores!!!

  7. 私は確信してこのポスト触れているすべてのインターネットユーザー人、その本当に本当に楽しい ポストウェブサイト|ブログ| |ウェブページ|ウェブサイト新しいブログを構築する上での段落。
    一部予約販売 セール対象商品

  8. 執筆のワンピース書き込みもある興奮、あなたがあれば、あなたがそうでなければあるいは に精通することはに精通していますそれはない場合複雑な複雑に書き込みます。
    完売これで最後 一部予約販売

  9. 何材料未曖昧と貴重な貴重なのpreservenessののトピックについて 精通ノウハウ 予測できません 気持ち。
    完売これで最後 棚卸し信用ある

  10. 良い一日!私が尋ねるはずと考えたのだが、 私はこれはちょっとオフトピックです知っています。リンクまたは多分ゲスト|あなたはの取引交換に興味があるオーサリング ブログ記事またはその逆?私と同じ多くのサイト カバー 科目あなたと私は信じとして、我々は非常にお互いに利益を得ることができます。場合は興味が撮影までお気軽に電子メール、電子メール私あなたがいる。あなたからの便りを楽しみにしています! 素晴らしい経由でブログ!
    商品到着後レビュー記載でプレゼント 限定saleお得

  11. ウェブサイト | これは素晴らしいですが、これが優れている |こんにちは、私は思います私は信じていません。私はそれをstumbledupon;)私がします 再訪 再びまだ お気に入りのそれとして保存。お金と自由は最高です 他の人々あなたが金持ちになるとし続けることができる、変更する方法。
    商品到着後レビュー記載でプレゼント 激安通販店です

  12. あなた私たちの 実際すべてでこれを共有するための| たくさんたくさん | おかげで、ありがとうございました 知る |あなたがしている、あなたが何であるかを約 |} 約話す {話!ブックマークさ。 ください さらに)= Webサイトサイト 。私たちは、があります リンク 交換 配置 の中私たちを
    2015春夏新色追加 一部予約販売

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s


%d bloggers like this: