blog:pushbx:2025:1026_installing_apache_hgweb_server_locally

Differences

This shows you the differences between two versions of the page.

@@ Line 1: / Line 1: @@
+====== Installing apache + hgweb server locally ======
+This post details how to install a hgweb server locally on
+an amd64 Debian 12 desktop machine,
+as suggested [[blog:pushbx:2025:1022_anonymous_sign_in_now_required_for_the_hgweb_server|in the hgweb sign-in post]].
+===== Apache =====
+Run the Synaptic Package Manager,
+mark apache2, apache2-bin, apache2-data, and apache2-utils for installation.
+They are version 2.4.65-1~deb12u1 on our current setup.
+Also mark mercurial and mercurial-common for installation.
+They are version 6.3.2-1+deb12u1 for us.
+Install the marked packages.
+===== hgweb =====
+According to https://510x.se/notes/posts/Install_Mercurial_and_hgweb_on_a_Debian-based_system/
+you can copy the hgweb.cgi file from an installed Mercurial package as follows:
+<code>mkdir -p ~/hg/cgi
+cp /usr/share/doc/mercurial-common/examples/hgweb.cgi ~/hg/cgi</code>
+The contents of this file on our machine are:
+<code>#!/usr/bin/env python3
+#
+# An example hgweb CGI script, edit as necessary
+# See also https://mercurial-scm.org/wiki/PublishingRepositories
+# Path to repo or hgweb config to serve (see 'hg help hgweb')
+config = b"/path/to/repo/or/config"
+# Uncomment and adjust if Mercurial is not installed system-wide
+# (consult "installed modules" path from 'hg debuginstall'):
+# import sys; sys.path.insert(0, "/path/to/python/lib")
+# Uncomment to send python tracebacks to the browser if an error occurs:
+# import cgitb; cgitb.enable()
+from mercurial import demandimport
+demandimport.enable()
+from mercurial.hgweb import hgweb, wsgicgi
+application = hgweb(config)
+wsgicgi.launch(application)</code>
+I edited the ''config ='' line to read ''config = b"/home/ecm/hg/cgi/hgweb.config"''
+The hgweb.config file contents are as shown in the following log:
+<code>~/hg/cgi$ cat hgweb.config
+#[collections]
+#/home/ecm/webrepos = /home/ecm/webrepos
+[paths]
+/ecm = /home/ecm/webrepos/*
+[ui]
+username = E. C. Masloch
+[web]
+allow_archive = gz, bz2, zip
+encoding = utf-8
+[extensions]
+highlight =</code>
+===== Place the repos =====
+Download a .tlz (tar lzipped) file from https://pushbx.org/ecm/backups.hg/ and unpack it:
+<code>mkdir webrepos
+cd webrepos
+tar -xf ~/Downloads/hg/20251019.tlz</code>
+===== Install hgweb as part of the apache server =====
+. Run ''chmod a+rx'' on the directories involved in the hgweb.cgi pathname
+. Enable CGI module in apache by running ''/etc/apache2/mods-enabled$ sudo ln -s ../mods-available/cgi.load''
+. Unlike what the 510x.se page states, create a file named ''/etc/apache2/conf-enabled/hg.conf'' (using sudo with a text editor), with the following contents:
+<code>ScriptAlias /hg "/home/ecm/hg/cgi/hgweb.cgi"
+<Directory "/home/ecm/hg/cgi/">
+	AllowOverride None
+	Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
+	Require all granted
+</Directory></code>
+. Run ''sudo service apache2 reload''
+. Navigate to http://127.0.0.1/hg/ecm?sort=lastchange
+{{tag>apache hg mercurial hgweb debian}}
+~~DISCUSSION~~

blog/pushbx/2025/1026_installing_apache_hgweb_server_locally.txt · Last modified: 2025-10-26 17:57:31 +0100 Oct Sun by ecm

pushbx wiki

User Tools

Site Tools

Differences

Page Tools