Skip to main content

FossBill

The code source behind fossbill.org.

Development

make instance/config.toml # Prepare the config, you may edit it
make venv-dev # Will prepare and install dependencies in venv
venv/bin/flask --app fossbill db upgrade head # Prepare and migrate the database
make run # Run the server

Production

python -m venv venv
venv/bin/python3 -m pip install fossbill waitress
venv/bin/python3 -m pip install psycopg2-binary # if you use postgres

Configure the instance

mkdir -p venv/var/fossbill-instance/
curl -o venv/var/fossbill-instance/config.toml https://git.sr.ht/~stacyharper/fossbill/blob/main/config.example.toml

Then edit this config.toml and setup the secret and database string.

Then migrate using:

venv/bin/flask --app fossbill db upgrade head

Running the server is as simple as:

venv/bin/flask --app fossbill run
# or
venv/bin/waitress-serve --listen=127.0.0.1:5554 --call 'fossbill:create_app'

But you should rather setup a system daemon, and a proxy using nginx. Have a look at the contrib/ folder.

Contribute

Send patches to the mailing list: Development mailing list.

To learn how to use git send-email, please see git-send-email.io.

git config format.subjectPrefix 'PATCH fossbill'
git config sendemail.to '~stacyharper/fossbill-devel@lists.sr.ht'

Metadata

Release files for fossbill 1.11.0

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

Built distribution (wheel)

Table of built distributions (wheels) for fossbill 1.11.0
File Interpreter ABI Platform
fossbill-1.11.0-py3-none-any.whl Python 3 none any Details

Release files / fossbill-1.11.0-py3-none-any.whl

Download URL fossbill-1.11.0-py3-none-any.whl
Size 83.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ecc8f18012ba568c6cecdd77f171b07249bbfae16051dc2bcc3daab86513f472
BLAKE2b-256 checksum
How to use checksums
c51a46a1b686f3872dd3eddf5a46ba717902f6422af76619519cdc3d7bbe6f24
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Release history Release notifications | RSS feed

This release

1.11.0 This release

1 release file

1.10.0

1 release file

1.9.0

1 release file

1.8.2

1 release file

1.8.1

1 release file

1.8.0

1 release file

1.7.0

1 release file

1.6.0

1 release file

1.5.0

1 release file

1.4.0

1 release file

1.3.0

1 release file

1.2.0

1 release file

1.1.0

1 release file

1.0.0

1 release file

0.21.1

1 release file

0.20.0

1 release file

0.19.0

1 release file

0.18.0

1 release file

0.17.0

1 release file

0.16.0

1 release file

0.14.0

1 release file

0.13.1

1 release file

0.11.0

1 release file

0.10.0

1 release file

0.9.2

1 release file

0.9.0

1 release file

0.8.1

1 release file

0.8.0

1 release file

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