Skip to main content

Fossil Director

Fossil-director is an HTTP server used to host multiple Fossil repositories, based on the hostname.

The server is meant to run behind nginx or other reverse proxy. Fossil-director will inspect the incoming HTTP Host: header and dispatch to the configured fossil repository.

Installation

(Requires Python >= 3.8)

pip install fossil-director

Configuration

A configuration .ini is required. At minimum, define a hostname and path to the fossil repository:

[example.com]
repo = /path/to/repo.fossil

Each virtual host is a new section. Here are all of the options:

[foo.org]
repo = /other/path.fossil
repolist = false                  # if repo is a directory, set this to true to serve 
                                  # a directory index of fossil files
baseurl = http://foo.org/fossil/  # base url
args = --nodelay --acme           # extra arguments to the `fossil http` command
redirect_root = /some/other/path  # redirect requests for / to the given URI

By default, the server runs on port 7000. Here are the server options:

[server]
host = 127.0.0.1
port = 7000
fossil_cmd = /usr/local/bin/fossil  # path to fossil executable

Running

fossil-director /path/to/config.ini

Here's an example systemd service

Metadata

Release files for fossil-director 1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fossil-director 1.0
File Size Uploaded
fossil_director-1.0.tar.gz 4.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fossil-director 1.0
File Interpreter ABI Platform
fossil_director-1.0-py3-none-any.whl Python 3 none any Details

Total release size: 8.8 kB

Release files / fossil_director-1.0.tar.gz

Download URL fossil_director-1.0.tar.gz
Size 4.2 kB
Tags Source
SHA-256 checksum
How to use checksums
0288e9d060f7d8801bc70188fe94dc0e15bb19c76ec8ff0ea5ce98c522c62cf6
BLAKE2b-256 checksum
How to use checksums
aae98e1744ea4c4fb8c78518751753ea6caa9f610a1926f0fb3976c61572093b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.12.4

Release files / fossil_director-1.0-py3-none-any.whl

Download URL fossil_director-1.0-py3-none-any.whl
Size 4.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a1dc40ca8d859a277c3e3e543ccd6691a48df107cc2bd7e062ecf6cef00b77d7
BLAKE2b-256 checksum
How to use checksums
491201e0c19599c9863d2a0839c14f46066912ee8c21fc84d0340745e3bdd510
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.12.4

Release history Release notifications | RSS feed

This release

1.0 This release

2 release files

0.2

2 release files

0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page