# System Requirements

Review the supported infrastructure, architecture, network access and minimum hardware recommendations before deployment.

Canonical: https://docs.mintsd.com/docs/mint-service-desk/system-requirements-system-requirements
Language: en-GB
Revision: 2a2d39f1e31deba465d9905cd685a5a3416966a588eb6151bba19ba5bc3c7cc9

<a id="element-01a1452d-eac9-7e78-9f92-327d01d1263a"></a>

Mint Service Desk runs in Docker, which provides operating-system-level virtualisation. The installation package includes the application, database and web server.

<a id="element-01a18bf4-2bd9-76d3-88ba-86fdcbf86af0"></a>

**System Requirements**

<a id="element-01a18bf4-2bda-7de5-b5f5-0acc53309520"></a>

Operating System

<a id="element-01a18bf4-2bdc-708e-9853-ff63f1a915ac"></a>

- Linux (recommended LTS distributions: Debian, Ubuntu, Alpine)
- The environment should ensure stability and long-term support.

<a id="element-01a18bf4-2bde-7507-83c6-45e2a3e243b8"></a>

**Solution Architecture**

<a id="element-01a18bf4-2bdf-7f38-b59c-f53b3d1414d2"></a>

Mint Service Desk is based on a microservices architecture consisting of approximately 30 independent components.

<a id="element-01a18bf4-2be0-7664-8020-03e7775038c2"></a>

Key Technologies:

<a id="element-01a18bf4-2be4-7505-adee-ccdabb25b503"></a>

- Backend: C#, .NET, .NET Core, Entity Framework, IdentityServer, SignalR, OpenID Connect
- Frontend: AngularJS, React (for Cloud versions), JavaScript, TypeScript, SCSS, CSS, HTML, SignalRJS, OpenID Connect
- Reverse Proxy: NGINX
- Container Orchestration: Docker, Docker Compose, Docker Swarm, Kubernetes (for Cloud versions)
- Message Queue: RabbitMQ
- Database: PostgreSQL

<a id="element-01a18bf4-2be5-79cc-870b-8bab19c57f93"></a>

**Data Layer**

<a id="element-01a18bf4-2be9-70c7-8121-4ea6330c8aae"></a>

- Database Engine: PostgreSQL
- Location: installed directly on the host (outside the container environment)
- Availability: local access only (localhost)
- Permissions: a dedicated application user with full access to the Mint Service Desk database
- Search engine: SOLR
- OCR: Tesseract

<a id="element-01a18bf4-2bea-7c3d-a56a-a5d9223092c0"></a>

**Application Layer**

<a id="element-01a18bf4-2bea-7af0-b0c1-af28e8dbea9b"></a>

The system runs in a Docker Swarm container environment and comprises approximately 30 .NET-based backend microservices, an AngularJS frontend application, a RabbitMQ server responsible for asynchronous communication, and integration and auxiliary components.

<a id="element-01a18bf4-2beb-78fd-878c-64d50510fa5e"></a>

The architecture provides horizontal scalability, component isolation and high service availability.

<a id="element-01a18bf4-2bed-712e-ba25-8de4711f2eee"></a>

**Communication Layer (Reverse Proxy)**

<a id="element-01a18bf4-2bf0-7ece-b6df-8ec4bc5736d0"></a>

- Technology: NGINX (running in a Docker container)
- Service Exposure:

  - Port 80 (HTTP) – used exclusively for health checks or redirects
  - Port 443 (HTTPS) – the primary access point to the system

<a id="element-01a18bf4-2bf1-74f1-af45-9e88b30118b6"></a>

The use of an SSL/TLS certificate is recommended (e.g. Let’s Encrypt or a commercially issued certificate).

<a id="element-01a18bf4-2bf3-7854-b2ac-bcc745b4d481"></a>

**API and Integrations**

<a id="element-01a18bf4-2bf4-7db0-b21c-c8361bca39bd"></a>

The system provides an extensive API enabling integration with external systems, such as Managed Service Provider (MSP) systems, monitoring tools and business systems.

<a id="element-01a18bf4-2bf6-73eb-b0fd-488e306b46d9"></a>

- API documentation is available in the Swagger (OpenAPI) standard.
- Authentication is implemented using the Client ID / Client Secret model, enabling secure access management for multiple integrations.

<a id="element-01a18bf4-2bf7-75b5-b87d-4e27cddfe81d"></a>

**Deployment Model**

<a id="element-01a18bf4-2bf8-76d3-9e5c-61ab4a68b66a"></a>

- The system can be deployed on-premises (within the customer’s infrastructure) or in a public cloud, such as AWS.
- The container-based architecture provides flexibility and allows the system to be adapted to different infrastructure environments.

<a id="element-01a18bf4-2bf9-7f8c-a86f-4f5590f637cb"></a>

**Minimum Hardware Recommendations**

<a id="element-01a18bf4-2bfb-7f34-8b32-1d50bf631ef5"></a>

- CPU: minimum 4 vCPUs
- RAM: minimum 16 GB
- Disk: minimum 500 GB (SSD recommended)
- Network: access to port 443 (HTTPS)

<a id="element-01a18bf4-2bfc-7cbc-b91c-70aea7864b1e"></a>

**Additional Requirements**

<a id="element-01a18bf4-2bfe-78e0-afca-064c86d5bb97"></a>

- SSH access to the server
- A public IP address or DNS configuration
- The ability to install Docker and Docker Swarm
- Access to the required network ports, particularly port 443 for HTTPS communication

