LedgerSMB

Small and Medium business accounting and ERP

Content

1. Description
2. System requirements
3. Quick start
4. Project information
5. Copyright
6. License

Description

LedgerSMB is a free web-based double-entry accounting system, featuring

• Quotations
• Ordering
• Invoicing
• Projects
• Timecards
• Inventory management
• Shipping
• and more ...

Directly send orders and invoices from the built-in e-mail function to your
customers or RFQs (request for quotation) to your vendors with PDF attachments,
from anywhere in the world with the browser-based UI.

With its data stored in the enterprise-strength PostgreSQL open source
database system, the system is known to operate smoothly for businesses with
thousands of transactions per week.

Customer visible output is fully customizable in templates, allowing easy and
fast customization. Supported output formats are PDF, CSV, HTML, ODF and more.

System requirements

Note that these are the system requirements for LedgerSMB 1.14, the current
development version. Please check the system requirements for the 1.13 stable
version.

Server

• Perl 5.38+
• PostgreSQL 14+
• Web server (e.g. nginx, Apache HTTPd, lighttpd, Varnish)

The web server is only required for production installs;
for evaluation purposes a simpler setup can be used, as detailed
below.

Client

The tables below show the browsers currently supported, their earliest dates
and a range of versions.

Desktop

Browser Name	Earliest	Versions
Chrome	2025-08	139-148
Edge	2025-08	139-148
Firefox	2025-07	141-150
Opera	2025-05	119-127, 131
Safari	2024-10	18.1-18.7, 26.0-26.4

Mobile

Browser Name	Earliest	Versions
Chrome for Android	2026-05	148
Firefox for Android	2026-04	150
Android Browser	2026-05	148
Safari on iOS	2024-10	18.1-18.7, 26.0-26.4
KaiOS Browser	2021-09	3.0-3.1
Opera Mobile	2024-03	80
Samsung Internet	2023-02	20-29

Note: Safari is very sensitive to using LedgerSMB over HTTPS; using it with
a regular HTTP connection is unsupported by the project team. Please be aware that
using HTTPS is the recommended setup, so that Safari is considered to be fully
supported.

Note: Earliest dates and versions come from http://caniuse.com. Only the most
recent data is available for Mobile browsers other than Safari, because they
are pushed out to the devices as soon as they are releases, so the number of
devices running old browsers is negligible.

Quick start

For from-tarball installation instructions, see https://ledgersmb.org/content/installing-ledgersmb-113

Installation

This instruction assumes you have Docker
installed as well as docker-compose.

bashCopy
 $ wget https://raw.githubusercontent.com/ledgersmb/ledgersmb-docker/1.13/docker-compose.yml
 $ docker-compose up -d

This creates both the LedgerSMB image and a database image with a persistent
database. Note that this setup is not sufficient for production purposes
because it lacks secure connections to protect your users' passwords.

❌ Do not use unofficial or AI-generated Docker Compose examples.
These are often incomplete, break silently, or skip required services.

Next steps

The system is installed and should be available for evaluation through

• http://localhost:5762/setup.pl
  Creation and privileged management of company databases
• http://localhost:5762/login.pl
  Normal login for the application

The system is ready for preparation for first
use.

NOTE: This setup does not use a webserver like nginx or Apache. Setups which
do include one will yield a faster user experience due to (much) faster page
load times and web request responses. For production setups, please consider
adding a webserver to the installation.

Project information

Security vulnerability reports: https://ledgersmb.org/contact/security_report

Web site: https://ledgersmb.org/

Repository: https://github.com/ledgersmb/LedgerSMB

Live chat: #ledgersmb:matrix.org (Matrix)

Groups:

• Reddit r/LedgerSMB
• LinkedIN LedgerSMB group
• Facebook LedgerSMB page
• Mastodon

Mailing lists:

• Announcements
• User Discussion
• Developer Discussion

Mailing list archives: https://archive.ledgersmb.org

Translations: Transifex online translation tool

Documentation: The book Running your business with LedgerSMB

Continuous integration (automated testing):

• GitHub Actions
• CircleCI

Code coverage: Coveralls

Project contributors

Source code contributors can be found in the project's git commit history
as well as in the CONTRIBUTORS file in the repository root.

Translation contributions can be found in the project's git commit history
as well as in the Transifex project Timeline.

Copyright

plainCopy
Copyright (c) 2006 - 2024 The LedgerSMB Project contributors
Copyright (c) 1999 - 2006 DWS Systems Inc (under the name SQL Ledger)

License

GPLv2