Skip to content

ylavoie/LedgerSMB

 
 

Repository files navigation

LedgerSMB

Small and Medium business accounting and ERP

CII Best Practices CI Lgtm total alerts GPLv2 Licence Coverage Status Docker Language grade: JavaScript Mentioned in Awesome <awesome-selfhosted> pull requests issues

DESCRIPTION

LedgerSMB is a free web-based double-entry accounting system, featuring quotation, 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.11.0-dev, the current development version. Please check the system requirements for the 1.8 old stable version and the 1.9 version.

Server

  • Perl 5.32+
  • PostgreSQL 13+
  • Web server (e.g. nginx, Apache, 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 date and a range of versions.

Desktop

Browser Name Earliest Versions
Chrome 2017-09 61-81, 83-105
Edge 2020-01 79-81, 83-105
Firefox 2018-05 60-104
Opera 2017-09 48-58, 60, 62-90
Safari 2017-09 11, 11.1, 12, 12.1, 13, 13.1, 14, 14.1,
15, 15.1, 15.2-15.6

Mobile

Browser Name Earliest Versions
Chrome for Android 2022-09 105
Firefox for Android 2022-08 104
Android Browser 2022-09 105
Safari on iOS 2017-09 11.0-11.4, 12.0-12.5, 13.0-13.7,
14.0-14.8, 15.0-15.6
Opera Mobile 2021-02 64
Samsung Internet 2018-12 8.2, 9.2, 10.1, 11.1-11.2, 12.0, 13.0,
14.0, 15.0, 16.0, 17.0, 18.0

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-19

Installation

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

 $ wget https://raw.githubusercontent.com/ledgersmb/ledgersmb-docker/1.10/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.

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

Web site: https://ledgersmb.org/

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

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

Live chat:

Mailing lists:

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

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

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

License

GPLv2

About

Master repository for the LedgerSMB project

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Perl 40.3%
  • HTML 32.0%
  • PLpgSQL 16.4%
  • Raku 3.5%
  • JavaScript 2.9%
  • Gherkin 1.5%
  • Other 3.4%