LedgerSMB
Integrated accounting and ERP system for small and midsize businesses, with double entry accounting, budgeting, invoicing, quotations, projects, orders and inventory management, shipping and more.
Integrated accounting and ERP system for small and midsize businesses, with double entry accounting, budgeting, invoicing, quotations, projects, orders and inventory management, shipping and more.
# LedgerSMB Small and Medium business accounting and ERP [](https://bestpractices.coreinfrastructure.org/projects/795) [](https://github.com/ledgersmb/LedgerSMB/actions/workflows/main.yml) [](https://github.com/ledgersmb/LedgerSMB/actions/workflows/codeql.yml) [](https://opensource.org/licenses/GPL-2.0/) [](https://coveralls.io/github/ledgersmb/LedgerSMB?branch=master) [](https://hub.docker.com/r/ledgersmb/ledgersmb/) [](https://github.com/Kickball/awesome-selfhosted#enterprise-resource-planning) ## Content 1. [Description](#description) 2. [System requirements](#system-requirements) 3. [Quick start](#quick-start) 4. [Project information](#project-information) 5. [Copyright](#copyright) 6. [License](#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](https://github.com/ledgersmb/LedgerSMB/tree/1.13#system-requirements). ## 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](https://docs.docker.com/get-docker/) installed as well as [docker-compose](https://github.com/docker/compose#where-to-get-docker-compose). ```bash $ 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](https://ledgersmb.org/content/preparing-ledgersmb-113-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](https://ledgersmb.org/contact/security_report) Web site: [https://ledgersmb.org/](https://ledgersmb.org) Repository: [https://github.com/ledgersmb/LedgerSMB](https://github.com/ledgersmb/LedgerSMB) Live chat: [#ledgersmb:matrix.org](https://app.element.io/#/room/#ledgersmb:matrix.org) (Matrix) Groups: * [Reddit r/LedgerSMB](https://www.reddit.com/r/LedgerSMB/) * [LinkedIN LedgerSMB group](https://www.linkedin.com/groups/13199807/) * [Facebook LedgerSMB page](https://www.facebook.com/LedgerSMB) * [Mastodon](https://mastodon.social/@LedgerSMB) Mailing lists: * [Announcements](https://lists.ledgersmb.org/postorius/lists/announce.lists.ledgersmb.org/) * [User Discussion](https://lists.ledgersmb.org/postorius/lists/users.lists.ledgersmb.org/) * [Developer Discussion](https://lists.ledgersmb.org/postorius/lists/devel.lists.ledgersmb.org/) Mailing list archives: [https://archive.ledgersmb.org](https://archive.ledgersmb.org) Translations: [Transifex online translation tool](https://app.transifex.com/ledgersmb/ledgersmb/dashboard/) Documentation: The book [Running your business with **LedgerSMB**](https://book.ledgersmb.org) Continuous integration (automated testing): * [GitHub Actions](https://github.com/ledgersmb/LedgerSMB/actions) * [CircleCI](https://app.circleci.com/pipelines/github/ledgersmb) Code coverage: [Coveralls](https://coveralls.io/github/ledgersmb/LedgerSMB?branch=master) ## 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 ```plain Copyright (c) 2006 - 2024 The LedgerSMB Project contributors Copyright (c) 1999 - 2006 DWS Systems Inc (under the name SQL Ledger) ``` # License [`GPLv2`](https://opensource.org/licenses/GPL-2.0)