You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Adële 99c1c95b36 Merge pull request 'Add warning when following an external capsule link' (#7) from rdelaage/ergol-http:main into main 8 months ago
.gitignore minor adapation and doc 10 months ago
.htaccess minor adapation and doc 10 months ago
LICENSE Initial commit 10 months ago correctly adding Romain as author 8 months ago
TwitterColorEmoji-SVGinOT.ttf add files 10 months ago
changelog.gmi add files 10 months ago
config-sample.php Gemserv config parser should be finished 8 months ago
ergol-http-screenshot.png Refresh readme screenshot 9 months ago
index.php Add warning when following an external capsule link 8 months ago
style.css Better style for blockquote and preformatted block 9 months ago
template.php Add template file 8 months ago


Ergol companion to serve #gemini capsules through http/https. It is a http wrapper written in php, working with ergol gemini server or standalone.

Screenshot of a web browser using ergol-http


ergol-http is under MIT/X Consortium License

ergol-http uses and provides a copy of Twitter Emoji aka twemoji packaged in a TrueType font format. twemoji is also published under MIT license.

Main repository on Codeberg.


Clone repository or unzip archive and copy main files in the document root of your website. Copy config-sample.php to config.php and change edit config.php to adapt it.

cd ~/
git clone
cd ergol-http
cp index.php style.css TwitterColorEmoji-SVGinOT.ttf .htaccess /var/www/
cp config-sample.php /var/www/config.php
nano /var/www/config.php

Web server needs to support url rewriting. Rule is present in .htaccess.

In Apache config:

RewriteEngine on
RewriteRule   "^/(.*)"  "/?q=$1"  [R,L]

In lighttpd config:

server.modules += ("mod_rewrite")
url.rewrite-once = ( "^/(.*)" => "/?q=/$1"  )

It is also possible to run ergol-http with php embedded web server (not the recommended way).

php -S -t ./ ./index.php


Get the last version the same way as installation but do not overwrite your config.php, check if there are new constants in config-sample.php and add them into your config.php.