// Global settings :ascii-ids: :encoding: UTF-8 :lang: en :icons: font :toc: :toc-placement!: :toclevels: 3 :numbered: :stem:
ifdef::env-github[] :imagesdir: https://raw.githubusercontent.com/kriolos-obiz/kriolos-pos/main/docs/src/main/images/ :tip-caption: :bulb: :note-caption: :information_source: :important-caption: :heavy_exclamation_mark: :caution-caption: :fire: :warning-caption: :warning: :badges: :doc-dir: https://github.com/kriolos-obiz/kriolos-pos/tree/main/docs :repo-base-url: https://github.com/kriolos-obiz/kriolos-pos/ endif::[]
[[doc]] = Kriol Open Source Point Of Sales :author: Copyright (c) KriolOS Team. :revnumber: 2025-08-26 :revdate: {last-update-label} {docdatetime} :version-label!:
WARNING: IN DEVELOPMENT (NOT RELEASE YET)
ifdef::badges[] == Build status
image:https://github.com/kriolos-obiz/kriolos-pos/actions/workflows/ci.yml/badge.svg["Build Status", link="https://github.com/kriolos-obiz/kriolos-pos/actions/workflows/ci.yml"] image:https://codecov.io/github/kriolos-obiz/kriolos-pos/coverage.svg["Code Coverage", link="https://codecov.io/gh/kriolos-obiz/kriolos-pos"] image:https://img.shields.io/badge/License-GPLv3-blue.svg["License: GPL v3", link="https://www.gnu.org/licenses/gpl-3.0.en.html"] image:https://badges.crowdin.net/krpos/localized.svg["Crowdin/Translation Status", link="https://crowdin.com/project/krpos"]
=== Stats
image:https://img.shields.io/github/issues-pr-raw/kriolos-obiz/kriolos-pos["GitHub Pull Requests", link="https://github.com/kriolos-obiz/kriolos-pos/pulls"] image:https://img.shields.io/badge/team-committers-green["GitHub Committers", link="https://github.com/orgs/kriolos-obiz/teams/obiz-core-team/members"] image:https://img.shields.io/github/contributors/kriolos-obiz/kriolos-pos["GitHub Contributors", link="https://github.com/kriolos-obiz/kriolos-pos/contributors"] image:https://img.shields.io/github/commit-activity/m/kriolos-obiz/kriolos-pos["GitHub Commit Activity", link="https://github.com/kriolos-obiz/kriolos-pos/commits"]
=== Release and Download
image:https://img.shields.io/github/release-date-pre/poolborges/unicenta-pos.svg["GitHub pre-release", link="https://github.com/poolborges/unicenta-pos/releases"] image:https://img.shields.io/github/release/poolborges/unicenta-pos.svg["GitHub release", link="https://github.com/poolborges/unicenta-pos/releases"] image:https://img.shields.io/github/downloads/poolborges/unicenta-pos/total["GitHub all releases", link="https://github.com/poolborges/unicenta-pos/releases"]
endif::[]
== About
Kriol Open Source Point Of Sales (kriolosPOS)
image::krpos-screenshot.gif[]
=== History of kriolosPOS
- kriolosPOS is a fork of UnicentaOPOS 4.5 (2019-06-30)
- UnicentaOPOS was a fork of OpenBravoPOS
- OpenbravoPOS was a fork of Librepos (previously named Tina POS) ** Adrian Romero was the founder and main developer for Tina POS
=== Pass Developers and Contributors
- @author Mikel Irurita
- @author jaroslawwozniak
- @author adrianromero (adrian)
- @author JG uniCenta (jack gerrard, jack)
- @author HS uniCenta
- @author Ryan Airey
- @author Ali Safdar and Aneeqa Baber
- @author jaroslawwozniak
- @author Luis Ig. Bacas Riveiro [email protected]
- @author Pablo J. Urbano Santos [email protected]
- @author Xibergy Systems
- @author JA
- @author poolborges
- @author Teodor Danciu ([email protected])
== Run App From source
.Example Compile and Execute (windows powershell/Terminal) [source,cmd]
.\mvnw.cmd compile install .\mvnw.cmd exec:java -pl kriolos-opos-app "-Dexec.mainClass=com.openbravo.pos.forms.StartPOS"
.Example Compile and Execute (Linux/Unix Bash) [source,bash]
./mvnw compile install ./mvnw exec:java -pl kriolos-opos-app "-Dexec.mainClass=com.openbravo.pos.forms.StartPOS"
== Run DB on Docker
.Run MySQL database for Developer Env
docker run --name unicenta -p 3306:3306 -d -e MYSQL_ROOT_PASSWORD=root -e MYSQL_DATABASE=unicenta -e MYSQL_USER=unicenta -e MYSQL_PASSWORD=unicenta mysql:5.6
.Run MariaDB database for Developer Env
docker run --name unicentaMDB -p 3306:3306 -d -e MARIADB_ROOT_PASSWORD=root -eMARIADB_DATABASE=unicenta -eMARIADB_USER=unicenta -eMARIADB_PASSWORD=unicenta mariadb/server:10.5
== Reference
- link:{doc-dir}/[Documentation]
== Screenshots
image::kriolos-opos-screenshot.gif[]