2025-08-04 06:49:49 +00:00
---
id: system-requirements
title: System Requirements
2026-02-16 10:35:23 +00:00
slug: /setup/system-requirements/
2025-08-04 06:49:49 +00:00
---
2025-08-18 09:28:04 +00:00
This document covers all the system requirements for self-hosting ToolJet.
2025-08-04 06:49:49 +00:00
:::info
The official Docker tag for the Enterprise Edition is tooljet/tooljet:ee-lts-latest.
:::
## Operating Systems
### Supported Linux distribution
[ToolJet images ](https://hub.docker.com/r/tooljet/tooljet/tags ) can run on any Linux machine with x86 architecture (64-bit). Ensure that your system meets the minimum requirements specified below before installing ToolJet.
### Microsoft Windows
ToolJet is developed for Linux-based operating systems. Please consider using a virtual machine or Windows Subsystem for Linux 2 (WSL2) to run ToolJet on Windows.
## VM deployments:
- **Operating System:** Ubuntu 22.04 or later
- **Processor Architecture:** x86 (arm64 is not supported)
2025-09-02 08:28:49 +00:00
- **RAM:** 4GB
2025-08-04 06:49:49 +00:00
- **CPU:** 1 vCPU
- **Storage:** At least 8GiB, but can increase according to your requirements.
## Orchestrated Deployments:
- When employing container orchestration frameworks like Kubernetes, it's imperative to ensure that your cluster hosts at least one node equipped with the above specifications for seamlessly executing ToolJet deployments.
Note: Adjustments can be made based on specific needs and the expected load on the server.
Enhance ToolJet deployment documentation for version 3.16.0-LTS (#14896)
* Enhance ToolJet deployment documentation for version 3.16.0-LTS
- Updated Google Cloud Run setup to clarify architecture and environment variables.
- Improved Kubernetes setup documentation for AKS, EKS, GKE, and general Kubernetes, emphasizing the need for two separate PostgreSQL databases.
- Revised OpenShift deployment instructions to include detailed environment variable configurations and deployment steps.
- Added system requirements for PostgreSQL and Redis, specifying recommended versions and minimum specifications.
- Included warnings about database naming conflicts and critical configurations for successful deployment.
* Enhance upgrade documentation for ToolJet LTS version
- Added critical backup reminder for PostgreSQL instance before upgrading.
- Clarified database requirements, emphasizing the need for two separate database names (PG_DB and TOOLJET_DB).
- Included deployment flexibility options for database hosting.
- Updated installation notes to specify that the upgrade guide is only for existing installations.
- Improved formatting and clarity in various setup guides (Azure, DigitalOcean, Docker, ECS, Google Cloud Run, Kubernetes, OpenShift).
* Enhance deployment documentation for ToolJet on various platforms, including AWS AMI, Azure Container Apps, AWS ECS, Google Cloud Run, Kubernetes (AKS, EKS, GKE), and Openshift. Updated warnings and notes regarding PostgreSQL database setup and ToolJet AI features.
* Enhance deployment documentation for ToolJet LTS version 3.16.0 by updating backup instructions, removing redundant version requirements, and clarifying Redis configuration for external instances.
* Refine deployment documentation for ToolJet by removing redundant environment variable references and adding notes on securing Redis passwords across various platforms including AWS AMI, Docker, Google Cloud Run, Kubernetes (AKS, EKS, GKE), and OpenShift.
* Refine Redis configuration instructions in AWS AMI deployment documentation for clarity and formatting consistency.
* Add new environment variables for bulk upload limits in deployment documentation
* Refine deployment documentation for ToolJet subpath installation by improving environment variable formatting and clarifying upgrade prerequisites.
* Update PostgreSQL database links in deployment documentation for consistency across ECS, Helm, Kubernetes (AKS, EKS, GKE), and OpenShift setups.
* Remove warning about whitelisting ToolJet AI features from Helm deployment documentation
* Refine environment variable configuration for workflow scheduling in Helm deployment documentation
* formatting updates till gke
* final formatting updates
---------
Co-authored-by: rudrapratik30 <pratik104agrawal@gmail.com>
2026-01-16 08:40:34 +00:00
## Database and Cache Software:
2025-08-04 06:49:49 +00:00
Enhance ToolJet deployment documentation for version 3.16.0-LTS (#14896)
* Enhance ToolJet deployment documentation for version 3.16.0-LTS
- Updated Google Cloud Run setup to clarify architecture and environment variables.
- Improved Kubernetes setup documentation for AKS, EKS, GKE, and general Kubernetes, emphasizing the need for two separate PostgreSQL databases.
- Revised OpenShift deployment instructions to include detailed environment variable configurations and deployment steps.
- Added system requirements for PostgreSQL and Redis, specifying recommended versions and minimum specifications.
- Included warnings about database naming conflicts and critical configurations for successful deployment.
* Enhance upgrade documentation for ToolJet LTS version
- Added critical backup reminder for PostgreSQL instance before upgrading.
- Clarified database requirements, emphasizing the need for two separate database names (PG_DB and TOOLJET_DB).
- Included deployment flexibility options for database hosting.
- Updated installation notes to specify that the upgrade guide is only for existing installations.
- Improved formatting and clarity in various setup guides (Azure, DigitalOcean, Docker, ECS, Google Cloud Run, Kubernetes, OpenShift).
* Enhance deployment documentation for ToolJet on various platforms, including AWS AMI, Azure Container Apps, AWS ECS, Google Cloud Run, Kubernetes (AKS, EKS, GKE), and Openshift. Updated warnings and notes regarding PostgreSQL database setup and ToolJet AI features.
* Enhance deployment documentation for ToolJet LTS version 3.16.0 by updating backup instructions, removing redundant version requirements, and clarifying Redis configuration for external instances.
* Refine deployment documentation for ToolJet by removing redundant environment variable references and adding notes on securing Redis passwords across various platforms including AWS AMI, Docker, Google Cloud Run, Kubernetes (AKS, EKS, GKE), and OpenShift.
* Refine Redis configuration instructions in AWS AMI deployment documentation for clarity and formatting consistency.
* Add new environment variables for bulk upload limits in deployment documentation
* Refine deployment documentation for ToolJet subpath installation by improving environment variable formatting and clarifying upgrade prerequisites.
* Update PostgreSQL database links in deployment documentation for consistency across ECS, Helm, Kubernetes (AKS, EKS, GKE), and OpenShift setups.
* Remove warning about whitelisting ToolJet AI features from Helm deployment documentation
* Refine environment variable configuration for workflow scheduling in Helm deployment documentation
* formatting updates till gke
* final formatting updates
---------
Co-authored-by: rudrapratik30 <pratik104agrawal@gmail.com>
2026-01-16 08:40:34 +00:00
### PostgreSQL
- **Version:** PostgreSQL 16.x is recommended
- **Minimum Specifications:**
- **RAM:** 8GB
- **Storage:** 20GB minimum (should scale based on data volume)
- **CPU:** 2 vCPUs
2025-08-18 09:28:04 +00:00
:::info
2025-09-02 09:07:20 +00:00
If you are currently on PostgreSQL 13.x, you may continue using it; however, upgrading to version 16.x is advised for improved performance and features. Additionally, PostgreSQL 13.x officially reached end-of-life in November 2025.
2025-09-02 08:28:49 +00:00
:::
Enhance ToolJet deployment documentation for version 3.16.0-LTS (#14896)
* Enhance ToolJet deployment documentation for version 3.16.0-LTS
- Updated Google Cloud Run setup to clarify architecture and environment variables.
- Improved Kubernetes setup documentation for AKS, EKS, GKE, and general Kubernetes, emphasizing the need for two separate PostgreSQL databases.
- Revised OpenShift deployment instructions to include detailed environment variable configurations and deployment steps.
- Added system requirements for PostgreSQL and Redis, specifying recommended versions and minimum specifications.
- Included warnings about database naming conflicts and critical configurations for successful deployment.
* Enhance upgrade documentation for ToolJet LTS version
- Added critical backup reminder for PostgreSQL instance before upgrading.
- Clarified database requirements, emphasizing the need for two separate database names (PG_DB and TOOLJET_DB).
- Included deployment flexibility options for database hosting.
- Updated installation notes to specify that the upgrade guide is only for existing installations.
- Improved formatting and clarity in various setup guides (Azure, DigitalOcean, Docker, ECS, Google Cloud Run, Kubernetes, OpenShift).
* Enhance deployment documentation for ToolJet on various platforms, including AWS AMI, Azure Container Apps, AWS ECS, Google Cloud Run, Kubernetes (AKS, EKS, GKE), and Openshift. Updated warnings and notes regarding PostgreSQL database setup and ToolJet AI features.
* Enhance deployment documentation for ToolJet LTS version 3.16.0 by updating backup instructions, removing redundant version requirements, and clarifying Redis configuration for external instances.
* Refine deployment documentation for ToolJet by removing redundant environment variable references and adding notes on securing Redis passwords across various platforms including AWS AMI, Docker, Google Cloud Run, Kubernetes (AKS, EKS, GKE), and OpenShift.
* Refine Redis configuration instructions in AWS AMI deployment documentation for clarity and formatting consistency.
* Add new environment variables for bulk upload limits in deployment documentation
* Refine deployment documentation for ToolJet subpath installation by improving environment variable formatting and clarifying upgrade prerequisites.
* Update PostgreSQL database links in deployment documentation for consistency across ECS, Helm, Kubernetes (AKS, EKS, GKE), and OpenShift setups.
* Remove warning about whitelisting ToolJet AI features from Helm deployment documentation
* Refine environment variable configuration for workflow scheduling in Helm deployment documentation
* formatting updates till gke
* final formatting updates
---------
Co-authored-by: rudrapratik30 <pratik104agrawal@gmail.com>
2026-01-16 08:40:34 +00:00
### Redis
- **Version:** Redis 7.x is required
- **Minimum Specifications:**
- **RAM:** 512MB (1GB recommended for production workloads)
- **Storage:** 1GB minimum
- **CPU:** 1 vCPU
:::info
Redis is used for caching and session management in ToolJet. Ensure that Redis 7.x is installed and running before deploying ToolJet.
:::
< br / >
---
## Need Help?
- Reach out via our [Slack Community ](https://join.slack.com/t/tooljet/shared_invite/zt-2rk4w42t0-ZV_KJcWU9VL1BBEjnSHLCA )
- Or email us at [support@tooljet.com ](mailto:support@tooljet.com )
- Found a bug? Please report it via [GitHub Issues ](https://github.com/ToolJet/ToolJet/issues )