Internal POS

MyCassa is the counter-side point-of-sale frontend designed to run on tablets or touchscreens inside your venue. It connects to MySagra API over the internal Docker network and is optimised for fast order entry in a busy, cash-based environment.

Requirements

A device with a modern browser (Chrome / Firefox / Safari)
The device must be on the same network as the server
The mkcert root CA must be installed on the device (see Docker) so HTTPS is trusted

Accessing MyCassa

Once the stack is running, navigate to:


https://YOUR_SERVER_IP

MyCassa is served by Nginx on port 443. The first visit will redirect you to the login page provided by MySagra API.

MyStampa — Receipt & ticket printing

MyStampa bridges the MySagra API real-time event stream and your thermal printers. It is configured entirely via environment variables in your .env file — there is no web UI.

Configuration

Variable	Description
`ADMIN_USERNAME`	Username for the MyStampa internal API
`ADMIN_PASSWORD`	Password for the MyStampa internal API
`USE_SSE`	Set to `true` to receive orders in real time via Server-Sent Events
`SSE_URL`	SSE endpoint on the MySagra API (default: `http://mysagra-api:4300/events/printer`)
`SINGLE_TICKET_CATEGORIES`	Comma-separated category IDs that should print one ticket per item instead of a summary

MyStampa listens on port 1234 and communicates with ESC/POS-compatible thermal printers over the network (IP).

Custom logo on receipts

MyStampa supports replacing the default MySagra logo on printed receipts with your own organisation’s logo.

How to add a custom logo

Create an assets/ folder inside your mysagra/ project directory (the same folder that contains docker-compose.yml):
```
mkdir -p assets
```

Place your logo file inside that folder with the exact name logo.png:


mysagra/
├── docker-compose.yml
├── .env
└── assets/
    └── logo.png   ← your logo here

The docker-compose.yml generated by the Quick Start already includes the correct volume mount:
```
volumes:
  - ./assets:/app/assets
```
So no further changes are needed — MySagra will use your logo.png instead of the default one on the next print.

Logo recommendations

Property	Recommendation
Format	PNG with transparent background
Width	400–576 px (thermal paper is narrow)
Height	up to 200 px
Colour mode	Greyscale or black & white for best results on thermal printers

After replacing the file, reload MyStampa or print a test receipt to verify the result.