Deprecated: This project has reached End-of-Life (EOL) / End-of-Support (EOS) due to uniCenta oPOS 5.x changes. No longer supported or updated.

UniOPOS

uniOPOS is a preconfigured installation package of uniCenta oPOS for Points of Sales (POS/ERP Open Source). It bundles uniCenta oPOS with complete web server stacks and database systems for easy deployment.

Migration Notice

This project is deprecated due to uniCenta oPOS 5.x. For migration information, see:uniCenta-oPos-5.0-Migration-Guide.pdf

Windows Installation

Download

File	OS	Size
uniOPOS.exe (.zip)	Windows 7/8/10/11 x64	1.58 GB

Installation Options

uniOPOS provides three installation packages: Package Selector

Install Pack
Portable Pack
WebServer Pack

uniCenta oPOS + WampServer Install Pack

Contents:

uniCenta oPOS v4.6.4 (.exe)
WampServer v3.3.0 x64 - Update 3.3.6
Apache 2.4.54.2
PHP 7.4.33 / 8.0.26 / 8.1.13 / 8.2.0
MySQL 5.7.40 / 8.0.31
MariaDB 10.10.2

Requirements:

Windows 10/11 x64 only
Port 80 free for Apache/phpMyAdmin
Root access without password (must create one)

uniCenta oPOS + Uniform Server Zero Portable Pack

Contents:

uniCenta oPOS v4.6.4 (no installer)
Uniform Server ZeroXV v15.0.2
Additional modules:
- adminer v4.8.3
- mysql autoback v1.0.2
- uniservice v2.5.2
- MySQL v5.7.37 from ZeroIV

Installation Path: %HOMEDRIVE%\PortableSrv\ Portable Shortcuts

uniCenta oPOS WebServer + MySQL WebServer Pack

Contents:

uniCenta oPOS WebServer v4.6.4
HeidiSQL v12.8 x64 Portable
MySQL Server v5.7.44 x64 (no-install package)

Default Credentials:

User: admin
Password: pwd
Access: http://localhost/phpmyadmin

Installation Process

Prepare System

Disable Antivirus, Antimalware, and SmartScreen
Close all applications
Verify system date and time
Backup existing installations if upgrading

Extract and Run

Unzip uniOPOS.exe (.zip) to desktop
Double-click executable
Accept privileged execution

Select Package

Choose Install, Portable, or WebServer package based on your needs.

Wait for Installation

Dependencies will install automatically:

Complete Setup

Installation complete message will appear:

Dependencies

Java Runtime

uniCenta oPOS requires Java 8:

Oracle Java 8 Update 421 x86 x64

Visual C++ Redistributables

Required for MySQL Server v5.7.x:

Microsoft Visual Basic/C++ Runtime x86
Microsoft Visual C++ 2005-2022 Redistributable x86 x64

Database Configuration

MySQL Server Requirements

uniCenta oPOS v4.x only uses MySQL Server v5.7.x (recommended by developers).Port Configuration: Always verify the port in uniCenta oPOS Control Panel matches MySQL:

jdbc:mysql://localhost:3306/

MariaDB Compatibility

If using MariaDB (not recommended), edit your .sql file:Replace:

ROW_FORMAT=COMPACT;

With:

ROW_FORMAT=DYNAMIC;

Database Management Tools

Install/Portable: phpMyAdmin included
WebServer: HeidiSQL included

Both packages support database migration from uniCenta oPOS 3.0+ and Openbravo POS 2.30

Recommended my.ini Settings

innodb_log_file_size = 512M
innodb_log_buffer_size = 32M
innodb_strict_mode = 0
max_allowed_packet = 128M

Java 8 Configuration

TLS Issues with MySQL

Java 8 (after April 2021) disables TLS 1.0/1.1 by default, causing connection errors:

com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:
Communications link failure
Error: javax.net.ssl.SSLHandshakeException: No appropriate protocol
(protocol is disabled or cipher suites are inappropriate)

Solution 1: Rollback
Solution 2: Disable TLS Check
Solution 3: Connection String

Downgrade to Java SE Runtime Environment 8u211:Download Java 8u211Or add to connection string:

?useSSL=no

Edit java.security file (as administrator):

Program Files\Java\jre-1.8(XXX)\lib\security\java.security

Comment out the SSL line:

# jdk.tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA, \
#      DH keySize < 1024, EC keySize < 224, 3DES_EDE_CBC, anon, NULL, \
#      include jdk.disabled.namedCurves

Save and reboot.

Add TLS version to connection string:Before Connector/J 8.0.28:

jdbc:mysql://localhost:3306/database_name?enabledTLSProtocols=TLSv1.2

Since Connector/J 8.0.28:

jdbc:mysql://localhost:3306/database_name?tlsVersions=TLSv1.2

IPv4 Configuration

Prevent Java from using IPv6 stack:

setx _JAVA_OPTIONS -Djava.net.preferIPv4Stack=true

WebServer Configuration

Remote Access

To access uniCenta oPOS WebServer from other computers:

Set Static IP

Configure static IP on your server

Edit jetty.properties

Edit \unicenta-webserver\jetty.properties:

# Change localhost to your server IP or 0.0.0.0
org.webswing.server.host=localhost

# Change the port if needed
org.webswing.server.http.port=8080

Enable Server Printing

Activate “Allow Server Printing” in settings:

Access Examples: Localhost Access

Linux Installation

Quick Start

wget -c -q https://raw.githubusercontent.com/maravento/vault/master/uniopos/resources/scripts/uniopos.sh
sed -i "s:your_user:$USER:g" uniopos.sh
sudo chmod +x uniopos.sh
sudo ./uniopos.sh

Linux Package Options

LAMP Stack
AMPPS Stack

Recommended for Linux

Bitnami LAMP v7.1.33-0 x64
MySQL Server v5.7.28 (do not update)
phpMyAdmin included
Default user: root
Default password: lampstack

Control commands:

sudo /opt/bitnami/ctlscript.sh restart mysql
sudo /opt/bitnami/ctlscript.sh restart apache

Alternative Linux Stack

AMPPS v3.8
MySQL Server v5.6.37 (older version)
May show compatibility warnings
Default MySQL user: root
Default MySQL password: mysql

Control commands:

# Start
sudo /usr/local/ampps/apache/bin/httpd
sudo /usr/local/ampps/mysql/bin/mysqld

# Stop
sudo killall httpd
sudo killall mysqld

Linux uniCenta oPOS

Desktop Installation
WebServer Installation

Start from desktop shortcut or command line:

# Start uniCenta oPOS
sudo /opt/unicentaopos-4.6.4/start.sh

# Stop
sudo pkill -f 'java'

Run uniCenta oPOS WebServer:

# Start
sudo /opt/unicenta-webserver/run.sh

# Access in browser:
# http://localhost:8080/unicentaopos/

# Stop
sudo pkill -f 'java'

When using WebServer, only enable MySQL Server, not Apache (Jetty is included).

Tested On

Distribution	Default User	Default Password	phpMyAdmin
Ubuntu 20.04/22.04 x64	root	lampstack / mysql	localhost/phpmyadmin

Troubleshooting

Java Repository Warning (Linux)

Java 8 is a third-party repository and may show error reports: Java Report

This is expected for third-party repositories.To remove Java completely: See StackExchange

phpMyAdmin Language

Portable pack starts in French. To change:

Log in to phpMyAdmin
Find “Paramètres d’affichage” (Appearance Settings)
Change “Langue” (Language) dropdown

PHP Configuration (UZero)

Uniform Server uses three php.ini variants:

php_test.ini
php_development.ini
php_production.ini (default)

Changes must be made to the active configuration file.

Important Notices

Backup Before Installing:If you have previous versions of uniOPOS or its components installed:

Backup databases and configurations
Stop related services
uniOPOS may remove previous installations

Architecture Requirements:

Some packages only support 64-bit architecture
Backward compatibility to Windows 10 not guaranteed

Disclaimer: Maravento Studio has no relationship with uniCenta oPOS developers. This installer is open source, sponsored by Uniopos SAS. Only the sponsor may use it commercially.

Getting Started

Security Tools

Network & Proxy

System Administration

Scripts & Utilities

Windows Tools

UniOPOS

UniOPOS

Migration Notice

Windows Installation

Download

Installation Options

Installation Process

Dependencies

Java Runtime

Visual C++ Redistributables

Database Configuration

Java 8 Configuration

TLS Issues with MySQL

IPv4 Configuration

WebServer Configuration

Remote Access

Linux Installation

Quick Start

Linux Package Options

Linux uniCenta oPOS

Tested On

Troubleshooting

Important Notices

Additional Resources

uniCenta Installation

uniCenta Configuration

Build docs developers (and LLMs) love

Getting Started

Security Tools

Network & Proxy

System Administration

Scripts & Utilities

Windows Tools

​UniOPOS

​Migration Notice

​Windows Installation

​Download

​Installation Options

​Installation Process

​Dependencies

​Java Runtime

​Visual C++ Redistributables

​Database Configuration

​Java 8 Configuration

​TLS Issues with MySQL

​IPv4 Configuration

​WebServer Configuration

​Remote Access

​Linux Installation

​Quick Start

​Linux Package Options

​Linux uniCenta oPOS

​Tested On

​Troubleshooting

​Important Notices

​Additional Resources

uniCenta Installation

uniCenta Configuration

Build docs developers (and LLMs) love

UniOPOS

Migration Notice

Windows Installation

Download

Installation Options

Installation Process

Dependencies

Java Runtime

Visual C++ Redistributables

Database Configuration

Java 8 Configuration

TLS Issues with MySQL

IPv4 Configuration

WebServer Configuration

Remote Access

Linux Installation

Quick Start

Linux Package Options

Linux uniCenta oPOS

Tested On

Troubleshooting

Important Notices

Additional Resources