This article describes the most common ways to integrate GIRI into your organization on the server side. It highlights technical details to help you and your IT department choose the most suitable solution. The four options below differ in their requirements, as well as in data security and access control levels.
If you have questions or need more details, please contact us.
General GIRI Server information
The GIRI server is the “backbone” of the GIRI application. All user data, instructions, media data, and spatial mapping data are stored here. The server also provides a web interface for managing instructions, assigning user permissions, and analyzing usage.
Technically, the GIRI server consists of a Node.js application (front-end and back-end) and a MongoDB database. Media storage with sufficient speed and capacity is required, as well as SMTP access to send system emails.
A centralized email service for usage assistance is only available for GIRI Cloud hosting.
1. Cloud Solutions
Our GIRI cloud instances are hosted by trusted providers like Google Cloud at multiple global locations for low latency.
Shared Cloud Server
Multiple customers’ data are securely hosted on the same instance, with strict separation. Setup is possible within minutes.
Available Shared Cloud locations:
Europe – Germany – Frankfurt
North America – USA – Iowa
Asia-Pacific – India – Delhi
Exclusive Cloud Server
A dedicated virtual machine for your company, fully maintained by AR-Experts. You choose the server location and can restrict access to IP ranges. Setup typically takes under two business days.
2. Custom Hosting: On-Premise or Self-Managed Cloud
On-premise or self-managed hosting offers maximum control and security but requires the most setup and ongoing maintenance.
Customer responsibilities:
Server/VM availability and reliability
Backups
Applying updates and patches
SSL/TLS certificate management
SMTP mail server configuration
Hardware requirements
Requirements depend on usage; values below reflect typical GIRI deployments.
Minimum requirements:
2 CPU cores (x64)
4 GB RAM
50 GB SSD free disk space (approx. 11 GB for Ubuntu OS)
IOPS: typically much lower but peaks up to 10k/s
Read/Write throughput: typically far lower but peaks at 250 MB/s
Storage usage example:
One average instruction = 16 steps = ~30 MB of media data
Example Google Cloud VM config:
Machine type: e2-medium
Disk: 100 GB Balanced persistent disk
OS and software requirements
Ubuntu 20.04 LTS “Focal Fossa” or newer (64-bit)
Server install image (headless, no desktop packages)
Setup requirements (must be fulfilled for installation)
Failure to meet these will prevent installation. Have your IT department prepare in advance.
SSH access to the target machine/VM for an AR-Experts service specialist (VPN allowed, no remote desktop solutions).
Connection speed: Reliable SSH with at least 100 Mb/s for file transfer.
Email server: SMTP server URL or IP with credentials; must be reachable by the GIRI server.
SSL/TLS certificates: Public and private key as separate
.pem
files, or access to a trusted CA (OpenSSL, AD CS). Only.pem
format supported.
Optional but highly recommended
Internet connection: Ideally at least temporarily for downloading required binaries and project files.
DNS record: So users can access via hostname instead of IP address.
3. Custom Hosting: Docker-based Installation
For teams preferring containerized deployments, GIRI can run in Docker containers. This provides portability, rapid setup, and isolated dependencies.
Advantages:
Deployment in minutes
Easy migration between environments
No dependency conflicts
Scalable with Docker Compose or Kubernetes
Requirements:
Docker Engine 20.10+
Docker Compose 2.x+
Hardware as above
MongoDB instance (container or external)
SSL/TLS certificates in
.pem
formatSMTP configuration
Setup steps:
Obtain official
docker-compose.yml
from AR-ExpertsConfigure environment variables (database, SMTP, SSL paths)
Run
docker compose up -d
Verify HTTPS and email delivery
Network requirements
HTTPS (port 443/8443) must be accessible from all mobile devices using GIRI.
Especially important for devices connected to internal company Wi-Fi.
Which hosting provider do you use - by default?
Like many big companies, including Deutsche Bank, Deutsche Börse, T-Systems, and Airbus, we trust in the security of Google Cloud. GIRI is hosted by default on Google Cloud. Google Cloud has been certified by the Bundesministerium für Informations Sicherheit (https://www.bsi.bund.de/DE/Home/home_node.html). More information about this certification can be found at https://cloud.google.com/security/compliance/bsi-c5.
What type of service does Giri provide?
SaaS Software as a Service
Is the cloud provider the same as the contract partner?
No. We use either Google Cloud or a service of your choice