Technical manualManual técnico › Installation › Before you install › The pieces and how they fitInstalación › Antes de instalar › Las piezas y cómo encajan
The pieces and how they fit
Las piezas y cómo encajan
Kubrik OS is one server application, a database, a cache, a file store and a web application served to the browser. This chapter says what each one does and the order of the installation.
Kubrik OS es una aplicación de servidor, una base de datos, una caché, un almacén de archivos y una aplicación web que se sirve al navegador. Este capítulo cuenta qué hace cada pieza y el orden de la instalación.
What gets installed
Qué se instala
| Piece | What it does | Version used by the delivery |
|---|---|---|
| Application (back end) | All the business logic and the API. One Java process that listens on port 8222. It runs the database migrations by itself every time it starts. | Java 25. Image kubrik-erp-be:<edition>, built from the source tree. |
| Database | Holds all the data of every organisation. | PostgreSQL 16 (postgres:16-alpine). |
| Cache | Real-time notifications, progress of background jobs and short-lived caches. | Redis 7 (redis:7-alpine). |
| File store | Product images, documents and every other uploaded file. Either a MinIO server or an Amazon S3 bucket. | MinIO (minio/minio) in the Enterprise file; none in the other two files. |
| Administration app (front end) | The screens people use. Static files served by nginx on port 80; nginx also forwards the API calls to the application. | Image kubrik-erp-fe:<edition>, built with Node 22 and served by nginx 1.27. |
| Pieza | Qué hace | Versión que usa la entrega |
|---|---|---|
| Aplicación (back end) | Toda la lógica de negocio y la API. Un proceso Java que escucha en el puerto 8222. Corre sola las migraciones de la base de datos cada vez que arranca. | Java 25. Imagen kubrik-erp-be:<edición>, construida desde el código fuente. |
| Base de datos | Guarda todos los datos de todas las organizaciones. | PostgreSQL 16 (postgres:16-alpine). |
| Caché | Notificaciones en tiempo real, avance de los trabajos en segundo plano y cachés de corta vida. | Redis 7 (redis:7-alpine). |
| Almacén de archivos | Imágenes de productos, documentos y cualquier otro archivo subido. Puede ser un servidor MinIO o un bucket de Amazon S3. | MinIO (minio/minio) en el archivo de Enterprise; ninguno en los otros dos archivos. |
| Aplicación de administración (front end) | Las pantallas que usa la gente. Archivos estáticos servidos por nginx en el puerto 80; nginx además reenvía las llamadas de la API a la aplicación. | Imagen kubrik-erp-fe:<edición>, construida con Node 22 y servida por nginx 1.27. |
One installation serves many organisations. Each organisation has its own users, modules and data, and every user signs in with the identifier of their organisation.
Una instalación atiende a muchas organizaciones. Cada organización tiene sus usuarios, sus módulos y sus datos, y cada usuario ingresa con el identificador de su organización.
How a request travels
Cómo viaja un pedido
- The browser loads the administration app from nginx (port 80).
- The app calls the API on the same address, under /api/. nginx forwards those calls to the application on port 8222.
- The application reads and writes the database, uses the cache and stores files in the file store.
- Files are downloaded straight from the file store through temporary links that the application signs, so the browser must be able to reach the file store address.
- El navegador carga la aplicación de administración desde nginx (puerto 80).
- La aplicación web llama a la API en la misma dirección, bajo /api/. nginx reenvía esas llamadas a la aplicación en el puerto 8222.
- La aplicación lee y escribe en la base de datos, usa la caché y guarda archivos en el almacén.
- Los archivos se descargan directo del almacén con enlaces temporales que firma la aplicación, así que el navegador tiene que poder llegar a la dirección del almacén.
Services you may add
Servicios que podés agregar
| Service | Needed for |
|---|---|
| Outbound e-mail | The verification message that activates a new organisation, and every other message the system sends. Without it the first organisation cannot be activated from the screens. |
| PDF renderer (Gotenberg) | Documents that are produced as PDF. The delivery files do not include it. |
| Location database (MaxMind GeoLite2) | The country suggested on the registration form and the location shown for each session. |
| Artificial intelligence provider | The assistant and the other functions that use a language model. Each organisation loads its own key. |
| Servicio | Para qué hace falta |
|---|---|
| Correo saliente | El mensaje de verificación que activa una organización nueva, y todos los demás mensajes que envía el sistema. Sin él no se puede activar la primera organización desde las pantallas. |
| Generador de PDF (Gotenberg) | Los documentos que salen en PDF. Los archivos de la entrega no lo incluyen. |
| Base de ubicación (MaxMind GeoLite2) | El país que se sugiere en el formulario de registro y la ubicación que se muestra de cada sesión. |
| Proveedor de inteligencia artificial | El asistente y las demás funciones que usan un modelo de lenguaje. Cada organización carga su propia clave. |
They are covered in Optional services.
Están en Servicios opcionales.
ℹ️
The storefront is a second web application that lives in the same source folder as the administration app. The delivery has no image for it: it is built separately with npm run build:storefront, and you serve the resulting files with your own web server.La tienda en línea es una segunda aplicación web que vive en la misma carpeta de código que la de administración. La entrega no trae una imagen para ella: se construye aparte con npm run build:storefront, y los archivos que resultan los servís con tu propio servidor web.
The order of the installation
El orden de la instalación
- Choose the edition. See Editions.
- Prepare the server and build the images. See Requirements and images.
- Fill in the settings and start the services. See Installing with Docker Compose and the Configuration reference.
- Create the first organisation and its administrator. See First start.
- Turn on the modules the organisation will use. See Modules of an organisation.
- Publish it under your own address with HTTPS. See Reverse proxy and HTTPS.
- Elegí la edición. Mirá Ediciones.
- Prepará el servidor y construí las imágenes. Mirá Requisitos e imágenes.
- Completá los ajustes y levantá los servicios. Mirá Instalar con Docker Compose y la Referencia de configuración.
- Creá la primera organización y su administrador. Mirá Primer arranque.
- Activá los módulos que va a usar la organización. Mirá Módulos de una organización.
- Publicalo bajo tu propia dirección con HTTPS. Mirá Proxy inverso y HTTPS.