Skip to main content
This page includes useful information on the requirements that are needed to install and run Chatwoot on your servers.

​
Operating Systems

​
Supported Linux distribution

  • Ubuntu (20.04)
Installation of Chatwoot is possible on most unix environments, but not officially supported.

​
Microsoft Windows

Chatwoot is developed for Linux-based operating systems. Please consider using a virtual machine to run Chatwoot on windows.

​
Software requirements

​
Ruby versions

  • Use the Ruby version pinned in Chatwoot’s .ruby-version and Gemfile. The current release uses Ruby 3.4.4.
You must use the standard MRI implementation of Ruby. Chatwoot needs several Gems that have native extensions.

​
Node.js versions

The current release requires Node.js 24.x. Use .nvmrc and the engines field in package.json from the release you are installing to select the supported version. Chatwoot uses Vite to compile frontend assets. Check your installed Node.js version with node --version. Installation instructions are available on the Node.js website.

​
pnpm versions

The current release requires pnpm 10.x. The packageManager field in package.json records the pinned version for the checkout. Check your installation with pnpm --version.

​
Hardware requirements

​
Storage

The necessary hard drive space largely depends on your usage, the size and number of attachments that you receive through your conversations etc.
Consider using a storage option provided by AWS, Azure, Google Cloud etc, if you want to stay flexible and accommodate the growing storage requirements. Chatwoot also supports other S3 API compatible services viz Minio, DigitalOcean Spaces, Linode Objects etc.

​
CPU

CPU requirements are dependent on the usage and expected workload. Your workload is influenced by factors such as - but not limited to - how active your users are, how many conversations do you receive and the conversation channels which you are using. The following is the recommended minimum CPU hardware guidance for a handful of example Chatwoot conversation base sizes.
  • 4 cores is the recommended minimum number of cores and supports up to 10,000 conversations a day.
  • 8 cores supports up to 20,000 conversations a day.
  • More conversations? Consider scaling horizontally by adding more application servers.

​
Memory

Memory requirements are dependent on the usage and expected workload. Your workload is influenced by factors such as - but not limited to - How active your users are, how many conversations do you receive and the conversation channels which you are using. The following is the recommended minimum Memory hardware guidance for a handful of example Chatwoot conversation base sizes.
  • 4GB RAM is the required minimum memory size and supports up to 10,000 conversations a day.
    • we are always working to reduce the memory requirement.
  • 8GB RAM supports up to 20,000 conversations a day.
  • More conversations? Consider scaling horizontally by adding more application servers.
Add at least 1GB of swap memory to the machine to ensure that the machine doesn’t run out of resources during an upgrade.

​
Database

PostgreSQL is the only supported database. We don’t have plans to support any other alternatives as of now.

​
PostgreSQL Requirements

The server running PostgreSQL should have at least 5-10 GB of storage available, though the exact requirements depends on the usage on your Chatwoot Instance. We highly recommend using the latest stable PostgreSQL versions as these were used for development and testing.

​
Redis

Redis stores the background task queue and various chatwoot configurations cached. The storage requirements for Redis are minimal, You can start with 100MB and scale up as required. Redis version 7.0 or higher is recommended

​
Sidekiq

Sidekiq processes the background jobs with a multi-threaded process. This process starts with the entire Rails stack but it can grow over time due to memory leaks. On a very active server the Sidekiq process can use 1GB+ of memory. You can opt to have both the sidekiq workers and rails servers to run on the same machine. But we recommend keeping the worker process and rails server on separate webservers for better scalability.

​
Supported web browsers

Chatwoot supports the following web browsers:
We don’t support running Chatwoot with JavaScript disabled in the browser.