--- title: How to adjust Hyperglance's memory allocation (Legacy Docker Guide) description: Adjust the memory allocation afforded to Hyperglance if the application is slow or you are seeing our of memory errors. --- [Skip to content](https://support.hyperglance.com/knowledge/memory-usage-legacydocker#main-content) English Show submenu for translations [More support](https://support.hyperglance.com/knowledge/kb-tickets/new?hsLang=en) ![](https://support.hyperglance.com/hs-fs/hubfs/hyperglance.png?width=100&height=75&name=hyperglance.png) Open main navigation Close main navigation - English Show submenu for translations - [More support](https://support.hyperglance.com/knowledge/kb-tickets/new) - [Contact Us](https://www.hyperglance.com/contact/) [Contact Us](https://www.hyperglance.com/contact/) How can we help you? - There are no suggestions because the search field is empty. 1. [Hyperglance Support](https://support.hyperglance.com/knowledge?hsLang=en) 2. [Setup & Configuration](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en) 3. [Legacy Docker-based deployments](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#legacy-docker-based-deployments) # How to adjust Hyperglance's memory allocation (Legacy Docker Guide) ## Adjust the memory allocation afforded to Hyperglance if the application is slow or you are seeing out of memory errors. THIS GUIDE IS DEPRECATED AND PERTAINS TO THE LEGACY DOCKER BASED ARCHITECTURE.  [SEE LATEST VERSION.](https://support.hyperglance.com/knowledge/memory-usage?hsLang=en) ### How Hyperglance uses memory Hyperglance stores inventory and billing data in-memory. Increasing RAM is the usually the best way to scale your Hyperglance deployment, not by increasing CPU, Disk or Network. By default 75% of the machine's RAM is allocated as "heap space" to the Hyperglance application.  This default works well for smaller deployments but on larger-scale deployments it can be necessary to adjust this to best utilize available memory. If you are experiencing OutOfMemoryError in the logs or severe slowdowns in the UI then increasing the memory allocation should help with that. ### Instance/VM RAM Guidelines Many factors affect the memory use: - Number of accounts - Number of resources - Amount of billing data The following table is a guideline based on the number of qualified resources in the license, just note this is approximate since many factors affect the memory use. For larger deployments we recommend memory-optimised instance/VM types intended for large memory applications such as Hyperglance. AWS offer the R5-series of instances. Azure offer E series VMs.  We advise finding the cheapest type that offers the RAM needed.   | **Hyperglance Variant** | **Recommended RAM** | **Optimal Heap Size** | **Example Instance/VM Size** | | --- | --- | --- | --- | | 250 Resources | 4GB | Default 75% | AWS: t3.medium Azure: Standard\_B2s (or equivalent) | | 500 Resources | 4GB | Default 75% | AWS: t3.medium Azure: Standard\_B2s (or equivalent) | | 1000 Resources | 8GB | Default 75% | AWS: t3.large Azure: Standard\_B2ms (or equivalent) | | 2000 Resources | 8GB - 16GB | Default 75% | AWS: t3.xlarge Azure: Standard\_B4ms (or equivalent) | | 5000 Resources | 32GB | 28GB | AWS: r5.xlarge Azure: Standard\_E4as\_v5 (or equivalent) | | 10000 Resources | 64GB - 128GB | 60GB - 120GB | AWS: r5.4xlarge Azure: Standard\_E16-4as\_v5 (or equivalent) | | 20000 Resources | 256GB | 250GB | AWS: r5.8xlarge Azure: Standard\_E32-8as\_v5 (or equivalent) |   ### Adjusting memory allocation You can configure a custom allocation by editing config.env: Edit file: ``` /var/lib/data/hyperglance/config.env ``` Set memory allocation to reflect a [recommendation:](https://support.hyperglance.com/knowledge/memory-usage-legacydocker#sizing) ``` MAX_HEAPSIZE=4g ``` Re-start the services: ``` sudo docker-compose -f /etc/docker-compose.yml up -d ```   - [Before You Start](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#main-content) - [Kubernetes](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#kubernetes) - [GCP](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#gcp) - [AWS](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#aws) - [Azure](https://support.hyperglance.com/knowledge/before-you-start?hsLang=en#azure) - [Using Hyperglance](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#main-content) - [Automations](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#automations) - [Inventory & Diagrams](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#inventory-diagrams) - [Rules](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#rules) - [Cost Management](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#cost-management) - [Dashboards](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#dashboards) - [Security & Compliance](https://support.hyperglance.com/knowledge/using-hyperglance?hsLang=en#security-compliance) - [Setup & Configuration](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#main-content) - [Updating & Migrating](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#updating-migrating) - [General](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#general) - [RBAC & Users](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#rbac-users) - [STIGS & FIPS](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#stigs-fips) - [AWS](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#aws) - [Azure](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#azure) - [Kubernetes](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#kubernetes) - [GCP](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#gcp) - [API](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#api) - [Legacy Docker-based deployments](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#legacy-docker-based-deployments) - [AI](https://support.hyperglance.com/knowledge/setup-configuration?hsLang=en#ai) [![Chill listening crop-3](https://support.hyperglance.com/hs-fs/hubfs/hyperglance.png?width=134&height=24&name=hyperglance.png "Chill listening crop-3")](https://www.hyperglance.com/) 2880 Zanker Road, Suite 203, San Jose, CA 95134 Copyright © 2025 Hyperglance. All rights reserved.