Skip to content

Latest commit

 

History

History
195 lines (128 loc) · 7.97 KB

README.md

File metadata and controls

195 lines (128 loc) · 7.97 KB
Raw

LedgerSMB

Small and Medium business accounting and ERP

CII Best Practices CI CodeQL GPLv2 Licence Coverage Status Docker Mentioned in Awesome <awesome-selfhosted>

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 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.13.0-dev, the current development version. Please check the system requirements for the 1.11 stable version.

Server

  • Perl 5.36.1+
  • PostgreSQL 13+
  • 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 2018-03 65-81, 83-130
Edge 2020-01 79-81, 83-130
Firefox 2018-05 60-131
Opera 2018-03 52-58, 60, 62-114
Safari 2018-09 12, 12.1, 13, 13.1, 14, 14.1, 15, 15.1,
15.2-15.6, 16.0-16.6, 17.0-17.6, 18.0

Mobile

Browser Name Earliest Versions
Chrome for Android 2024-09 129
Firefox for Android 2024-09 130
Android Browser 2024-09 129
Baidu Browser 2024-03 13.52
Safari on iOS 2018-09 12.0-12.5, 13.0-13.7, 14.0-14.8,
15.0-15.8, 16.0-16.7, 17.0-17.6, 18.0
KaiOS Browser 2021-09 3.0-3.1
Opera Mobile 2024-03 80
Samsung Internet 2019-04 9.2, 10.1, 11.1-11.2, 12.0, 13.0, 14.0,
15.0, 16.0, 17.0, 18.0, 19.0, 20-25

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

Installation

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

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

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:

Mailing lists:

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

Translations: Transifex online translation tool

Documentation: The book Running your business with LedgerSMB

Continuous integration (automated testing):

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

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

License

GPLv2