Skip to Content
MySagra 1.5.0 is released πŸŽ‰
DocumentationSelf HostingInternal POS

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

VariableDescription
API_URLThe url of the server API
MYSTAMPA_TOKENGenerate the apposite api key from the admin panel MyAmministratore

MyStampa listens on port 3032 and communicates with ESC/POS-compatible thermal printers over the network (IP). Actually we created a little UI that show to you the printers status and you can set wich categories have the single ticket.


Custom logo on receipts

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

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

    mkdir -p assets
  2. Place your logo file inside that folder with the exact name logo.png:

    mysagra/ β”œβ”€β”€ docker-compose.yml β”œβ”€β”€ .env └── assets/ └── logo.png ← your logo here
  3. 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.

If you are running the service without docker put the image logo.png in the folder assets of the repository.

Logo recommendations

PropertyRecommendation
FormatPNG with transparent background
Width400–576 px (thermal paper is narrow)
Heightup to 200 px
Colour modeGreyscale or black & white for best results on thermal printers

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

Last updated on