πOverview
π° Introduction
A Private Instance of Ellipsis Drive allows you to run the platform in your own (virtual) environment. It supports both standalone deployments and integration with existing storage infrastructure, including object storage and file-based storage systems.
Private Instances can run in any infrastructure that supports Docker-based workloads, including AWS, Google Cloud Platform, Microsoft Azure, on-premises environments, or hybrid architectures. They can also operate across geographically distributed architectures, enabling global performance optimisation for distributed users.
π½ System model
Ellipsis Drive functions as a control layer on top of existing storage infrastructure (passive storage).
This architecture provides:
Unified access management across datasets
Search and discovery across distributed storage
Interoperability across formats and systems
Scalable data processing and delivery
External storage systems, such as S3 buckets or other object storage, can be mounted to an Ellipsis Drive instance. Once indexed, these storage locations appear as read-only synced folders and can be explored alongside native Ellipsis Drive content.
Data in mounted storage remains managed by the underlying storage system and is not modified through Ellipsis Drive. These sources remain external to Ellipsis Driveβs storage layer.
When spatial data from mounted storage is processed or edited through Ellipsis Drive workflows, the resulting outputs are written as new versions within Ellipsis Drive. This ensures consistent processing while preserving the original state of the external data.

π Components
Ellipsis Drive consists of 10 containerised components, that are each launched on a (virtual) server running linux Ubuntu 16 or higher. Each component runs in its own docker (virtual) environment.
List of components π
1οΈβ£ Container with source code: to launch and run the API. (pool)
2οΈβ£ Cache database: A container with a database that caches relevant information to ensure scalability with a lot of usage (across geographical regions). This component is not required and can be skipped if the system is running on a single geographical location and the expected load is modest. (pool)
3οΈβ£ Central metadata database: A container with the central database with metadata and some logic to communicate with cache databases. (unique)
4οΈβ£ Temporary file storage: Container functioning to receive up- and downloads before passing them on to their permanent location. (unique)
5οΈβ£ Active vector data storage: Container with log(n) efficient, scalable and flexible vector reading capabilities (pool)
6οΈβ£ Active raster data storage: Container with scalable and flexible raster storage capabilities. (pool)
7οΈβ£ Background processes: This container contains some logic that runs in low frequency on the background. (pool)
8οΈβ£ Main cluster node: This container contains logic that distributes tasks over the cluster (unique)
9οΈβ£ Raster activation node: This container is assigned tasks by the main cluster nodes and activates raster layers on request. (pool)
π Vector activation node: This container is assigned tasks by the main cluster nodes and activates vector layers on request. (pool)
S3 storage or file server: This container does not host any ED specific logic and can be any system of storage that a client wishes to have their ED running on. (Pool)
The ED UI/app can be hosted on any location of convenience. Either on the API, or if preferred on some other location of your choosing.
π Security configuration
Ellipsis Drive supports configurable security policies to match enterprise environments.
List of things that can be configured π
Two-factor authentication requirements
Access control for public and link sharing
Direct access to passive storage (restricted or allowed)
Network restrictions (internet or intranet only)
Single sign-on integration
User registration policies (including SSO-only environments)
Access token creation and expiry policies
πΆ Scaling and distribution
Private Instances are designed for distributed, cloud-native architectures.
Services can be distributed across regions
Core components can scale horizontally
Kubernetes is supported for orchestration
Caching layers can be deployed independently of storage systems
βοΈ Infrastructure requirements
Running a Private Instance requires both system-level infrastructure and operational configuration within your cloud environment.
Ellipsis Drive manages the platform control layer, while your organization remains responsible for the underlying infrastructure and operations.
List of requirements and recommendations π
Each component requires a Linux-based environment (Ubuntu 18 or higher recommended)
Minimum hardware per component: 16GB RAM, 32GB storage, and 8 CPU cores
Components can run on shared infrastructure, but separation is recommended for optimal performance
A load balancer is required when running multiple API instances
The central database and temporary file storage must be hosted on the same physical location (in geographic proximity).
Object storage can be mounted to Ellipsis Drive as synced, read-only folders. These can be viewed and managed alongside native Ellipsis Drive content.
π§© Customer responsibilities
You are responsible for configuring and managing the underlying cloud infrastructure where Ellipsis Drive is deployed.
This includes infrastructure-level services and operational settings provided by your cloud environment.
List of responsibilities π
Backups You are responsible for backing up your passive storage. Active raster and vector layers can be reconstructed from passive storage, making this the critical backup layer.
Cloud armor Protection against threats such as DDoS attacks should be configured using your cloud providerβs security services.
Load balancing (multi-region or scaled deployments) Required when distributing workloads across regions or scaling API instances.
Auto scaling Ellipsis Drive can use available resources, but does not provision infrastructure automatically. Dynamic scaling must be configured within your cloud environment.
π Deployment
A dedicated Ellipsis Drive expert supports the deployment process as part of the license.
Deployment consists of:
Deploying Ellipsis Drive components in your environment
Connecting your storage system
Configuring system settings
Initializing services
Core components such as the central database and storage layer must be deployed first, as they are prerequisites for dependent services.
Ellipsis Drive support can only access your infrastructure if your organization explicitly grants permissions. Limited access is recommended to ensure efficient support and troubleshooting.
Last updated