For developers
An open-source headless shop system you can read, run and change.
What OpenTaberna is
We started OpenTaberna because Shopware is expensive and incompatible with nearly everything we needed to connect, so we built an open-source Shopware alternative. OpenTaberna separates the storefront, administration and backend, then puts automation at the centre: from catalogue and checkout to stock, payment and fulfilment.
It is a headless shop by design and self-hosted by default. You run it on your own servers, choose the interfaces, services and deployment around it, and build the custom web shop your business needs instead of adapting your operation to a closed product.
What it is made of
-
fastapi
The Python backend owns the API, commerce domain, integrations and automated order workflow.
-
frontend
The Angular storefront gives customers catalogue, account, cart and checkout experiences.
-
admin_frontend
The role-protected back office manages products, inventory, orders and returns.
-
wiki
The documentation repository is the single source of truth for setup, architecture and operation.
What it runs on
A self-hosted e-commerce stack built from well-known open-source parts, started with Docker Compose:
- Backend: Python and FastAPI, with async SQLAlchemy on PostgreSQL and Redis for background jobs.
- Storefront and back office: Angular, talking to the API. It is headless, so you can bring your own frontend.
- Accounts: Keycloak single sign-on for customers and staff.
- Payment and shipping: Stripe for payments, DHL for shipping.
- Documents and files: Paperless-ngx for accounting documents, MinIO as S3-compatible storage.
- Operations: Prometheus, Grafana and OpenTelemetry.
How to start
Start with the documentation
Read the OpenTaberna wiki, then follow the source-controlled Getting Started guide.
Setup instructions live there, not here, so the wiki remains the one current source of truth.
Licence and intent
OpenTaberna is entirely open source: every repository is licensed under Apache-2.0. You are free to run it, fork it, maintain it for your own needs or sell it on. The software stays free. Paid help with setup, hosting and custom storefronts comes from vaultops, run by one of the founders.