Software & Hardware Requirements

Software Requirements

See below for a detailed list of supported and recommended versions.

If you want to deploy Grape in an environment that doesn not fit the requirements, please contact us.

Client Software

Desktop Web

You don’t need to meet those requirements if you are going to install the desktop app on the clients.

  • PC: IE11, Edge, Chrome 50+, Firefox 43+
  • Mac: Safari 9+, Chrome 50+
  • Linux: Chrome 50+, Firefox 43+

Desktop Apps

  • PC: Windows 7, Windows 8.1, Windows 10
  • Mac: OS X 10.11+

Mobile Apps

  • iOS: iPhone 5 and later with iOS 10+
  • Android: Android devices with Android 5.0+
  • Windows 10 Mobile

Server Software

Using the Grape VM image

Requires a VM capable of running an OVF file.


  • VMware vSphere 5.1+ or VMware Hypervisor 5.1+
  • Windows Server 2012 R2 with Hyper-V or Hyper-V Server 2012 R2 or newer.

Using a custom OS

Any OS that runs docker 17.03 or higher, ce only. It is recommended to choose an OS that uses systemd.


  • Debian 9
  • Ubuntu 16.04 LTS / 18.04 LTS
  • RHEL/CentOS 7

Software required:

  • ansible (will be installed automatically by the Grape installer)
  • docker-engine 18.03.0 or higher, community edition
  • docker compose 1.22 or higher
  • wget, curl, git, pip
  • your favourite editor

Using external Databases


  • Version 10.3 or higher

  • trigram and unaccent extension loaded and configured for the chatgrape database

    • pg_trgm extension from package postgresql-contrib enabled (CREATE EXTENSION IF NOT EXISTS pg_trgm; on the chatgrape database)
    • unaccent extension from package postgresql-contrib enabled (CREATE EXTENSION IF NOT EXISTS unaccent; on the chatgrape database)
    • gin/gist operator classes enabled: UPDATE pg_opclass SET opcdefault = true WHERE opcname in ('gin_trgm_ops', 'gist_trgm_ops');
    • bundled configuration in one command:
    psql -U postgres -d chatgrape -c "
       UPDATE pg_opclass SET opcdefault = true WHERE opcname in ('gin_trgm_ops', 'gist_trgm_ops');

    make sure the user, in this case postgres, has root permissions on the chatgrape database

Hardware Requirements

Storage Requirements

Grape Server

  • Base Install: Grape takes up ~2,5gb and it is recommended to use an SSD.
  • Every update will require additional 200mb
  • Database:
    • elasticsearch: ~2gb / 100 user / year
    • postgres: 200mb / 100 user / year

File Storage Hardware

  • For small setups, all files can be stored on the Grape server itself
  • It is recommended to use a SAN/NAS if available.

The storage is mainly for files that are uploaded directly to the chat. Other files include: previews for uploaded images, user avatars.

Grape can easily be configured to use any SAN/NAS solution that can be mounted with Linux

File Storage Calculation

Our experience with daily Grape usage where most files are in other document management systems (Sharepoint, Google Drive, …) is ~30 MB / month / user (mostly screenshots, photos, PDFs)

Calculation: Upload per user per month * 12 * number of users

Example (100 users): 30 MB * 12 * 100 = 36,000 MB (per year)