# Technical Overview

### Introduction

Ludi is a dynamic, real-time application providing users with a rich interactive environment to work collaboratively. It is primarily deployed into a virtual private cloud operated by Deqo Software Ltd and provided in the form of Software as a Service.

This article describes the architecture of Ludi. See our [Security](https://ludi.co/security) and [Privacy Policy](https://ludi.co/privacy) pages for more information on our security and data protection practices.

### Logical Topology

Ludi is exposed to customers as a [single page web application](https://en.wikipedia.org/wiki/Single-page_application). Behind this, there are a number of services working in synergy to provide a working service. From a logical perspective (ignoring hardware), these are:

<table><thead><tr><th>Service</th><th width="354">Product / Provider</th><th width="150">Role</th></tr></thead><tbody><tr><td>Web Gateway</td><td>Caddy</td><td>Acts as reverse proxy and load balancer.</td></tr><tr><td>Content Delivery Network</td><td>BunnyCDN</td><td>Provides edge cache for static assets &#x26; SPA build files.</td></tr><tr><td>App Server</td><td>NodeJS Application</td><td>Application API (HTTP based) and Auth/Login UI.</td></tr><tr><td>Podopolis</td><td>Elixir Application</td><td>Socket server that enables the real time collaboration functionality.</td></tr><tr><td>Main Database</td><td>Postgres</td><td>Stores all system data except for board contents.</td></tr><tr><td>Object Database</td><td>MongoDB</td><td>Stores board contents.</td></tr><tr><td>Cache</td><td>Redis</td><td>Provides a cache and short term storage solution.</td></tr><tr><td>Message Queue</td><td>Rabbit MQ</td><td>Enables inter-service communication between components.</td></tr><tr><td>File Store</td><td>S3 Compatible Storage</td><td>Stores static assets &#x26; user uploaded data.</td></tr><tr><td>App Worker</td><td>NodeJS Application</td><td>Background job processor for various system tasks/functionality.</td></tr><tr><td>Snapper</td><td>NodeJS Application</td><td>Generates board preview images via Puppeteer.</td></tr></tbody></table>

The diagram below shows the logical topology layout including the data transfer routes. Blue lines are one way transfers, purple lines are bi-directional transfers.

![](/files/5pH1ZWNy07HD5zgHUvFp)

### Physical Topology

#### Cloud Deployment

Within the main cloud deployment, we utilize Digital Ocean with the following:

* Ubuntu VMs for App Server, App Worker, Snapper, Podopolis, Rabbit MQ, Redis & Caddy
* Digital Ocean Managed Postgres & MongoDB instances
* Digital Ocean Spaces (S3 Compatible Storage)
* Bunny CDN as the external CDN provider

Each component runs directly on a dedicated VM of a size applicable for the current system load.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ludi.co/technical/technical-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.