이 가이드는 Mattermost 배포를 위한 최소 소프트웨어 및 하드웨어 요구 사항을 설명합니다. 요구 사항은 사용량에 따라 달라질 수 있으며, 규모를 확장하기 전에 파일럿 프로젝트의 성능을 관찰하는 것을 권장합니다.

배포 개요#

이 문서에서 요구 사항을 설명하는 소프트웨어 시스템 및 구성 요소의 요약은 애플리케이션 아키텍처 문서를 참조하세요.

소프트웨어 요구 사항#

클라이언트 소프트웨어#

데스크톱 앱#

공식적으로는 지원되지 않지만 Linux 데스크톱 앱은 RHEL/CentOS 7+에서도 실행됩니다.

Flatpak 패키지 요구 사항(Linux)#

Mattermost Desktop v6.1부터 Flatpak 패키지가 Linux에서 사용 가능합니다(현재 베타). Flatpak 버전에는 다음이 필요합니다.

• 시스템에 Flatpak 런타임 설치
• Freedesktop Platform/SDK 25.08
• Electron BaseApp 25.08
• 의존성을 위한 Flathub 또는 호환 Flatpak 리포지터리 접근

Flatpak 패키지는 x86_64(Intel/AMD) 및 aarch64(ARM) 아키텍처에서 사용 가능합니다. Flatpak 버전에는 Wayland 디스플레이 서버 지원이 기본적으로 활성화되어 있습니다.

PC 웹#

* Internet Explorer(IE11)는 더 이상 지원되지 않습니다. Mattermost 데스크톱 앱 또는 지원되는 다른 브라우저를 사용하는 것을 권장합니다. 자세한 내용은 이 포럼 게시물을 참조하세요.

모바일 앱#

모바일 웹#

이메일 클라이언트#

• 데스크톱 클라이언트: Outlook 2010+, Apple Mail 버전 7+, Thunderbird 38.2+
• 웹 기반 클라이언트: Entra ID, Outlook, Gmail, Yahoo, AOL
• 모바일 클라이언트: iOS Mail 앱(iOS 7+), Gmail 모바일 앱(Android, iOS)

서버 소프트웨어#

Mattermost 서버 운영 체제#

• Ubuntu 22.04+, Debian Bookworm+, CentOS Stream 9+, Red Hat Enterprise Linux 9+, Oracle Linux 9+.
• Docker 호환 운영 체제(Linux 기반 OS)에서 Mattermost Docker 배포를 사용하는 것이 여전히 권장됩니다.

Fedora, FreeBSD, Arch Linux에 대한 커뮤니티 지원이 존재하지만, Mattermost는 현재 이러한 플랫폼에 대한 프로덕션 지원을 포함하지 않습니다.

데이터베이스 소프트웨어#

• PostgreSQL 15.0+

PostgreSQL의 Amazon Aurora 동등 제품도 지원됩니다. 마이그레이션 가이드에서 MySQL에서 PostgreSQL로 마이그레이션하는 단계, 도구 및 지원에 대해 설명합니다.

최소 PostgreSQL 데이터베이스 지원 정책#

계획 수립을 쉽게 하고 Mattermost 배포가 빠르고 안전하게 유지되도록, 지원되는 PostgreSQL 최소 버전 업데이트에 관한 정책을 도입합니다. Mattermost가 지원하는 가장 오래된 PostgreSQL 버전은 PostgreSQL 커뮤니티에서 지원하는 가장 오래된 버전과 일치합니다. 이를 통해 최신 기능과 보안 업데이트의 혜택을 받을 수 있습니다.

이 정책 변경은 Mattermost v10.6부터 적용되며, 필요한 최소 PostgreSQL 버전은 PostgreSQL 13이 됩니다. 이는 각 메이저 버전에 5년간의 지원을 제공하는 PostgreSQL 커뮤니티 지원 정책과 일치합니다.

PostgreSQL 버전이 수명 종료(EOL)에 도달하면 Mattermost는 다음 예정된 ESR 릴리즈부터 더 새로운 버전을 요구합니다. 이는 향후 PostgreSQL 최소 버전이 다음과 같이 증가함을 의미합니다.

고객은 새 요구 사항이 적용되기 전에 PostgreSQL 버전을 계획, 테스트 및 업그레이드할 수 있는 9개월의 기간을 갖습니다. 이 정책은 데이터베이스 업그레이드를 Mattermost 릴리즈 일정에 맞출 수 있도록 명확성과 투명성을 제공하는 것을 목표로 합니다. 옵션에 대해 논의하려면 Mattermost 전문가. 에게 문의하세요.

데이터베이스 검색 제한 사항#

일반적인 제한 사항:

• 훨씬 더 큰 파일을 업로드할 수 있더라도 파일 콘텐츠의 처음 1MB만 검색에 사용할 수 있습니다.

PostgreSQL 검색 제한 사항:

• 이메일 주소는 결과를 반환하지 않습니다.
• 대시가 포함된 사용자 이름의 해시태그 또는 최근 멘션은 검색 결과를 반환하지 않습니다.
• 대시가 포함된 용어는 검색 쿼리에서 대시가 무시되므로 잘못된 결과를 반환합니다.
• PostgreSQL 자체의 제한 사항:
  • 그 중 하나는 The length of a tsvector (lexemes + positions) must be less than 1 megabyte 로, 파일 콘텐츠에 따라 1MB 미만의 콘텐츠를 가진 파일도 tsvector 제한인 1MB에 도달하면 검색할 수 없다는 의미입니다.
• 위의 사항이 문제인 경우 엔터프라이즈 검색을 설정하고 활성화할 수 있습니다.

MySQL 지원#

MySQL 데이터베이스 지원은 Mattermost v11부터 지원 중단될 예정입니다. MySQL에서 PostgreSQL로 마이그레이션하는 방법은 PostgreSQL 마이그레이션 문서를 참조하세요.

• MySQL 검색 제한 사항: 점이 포함된 사용자 이름의 해시태그 또는 최근 멘션은 검색 결과를 반환하지 않습니다.
• 마이그레이션 시스템은 스키마 마이그레이션을 실행하기 위해 MySQL 데이터베이스 사용자에게 추가 EXECUTE, CREATE ROUTINE, ALTER ROUTINE 및 REFERENCES 권한이 필요합니다.
• MariaDB v10+는 MySQL 5.7.12 요구 사항으로 인해 더 이상 MySQL 드롭인 대체 제품으로 작동하지 않으며, Mattermost에서 지원되지 않습니다. 이전 버전의 MariaDB는 공식적으로 지원되지 않았지만 이전 Mattermost 릴리즈에서는 작동했을 수 있습니다. 현재 MariaDB를 실행 중인 경우 MariaDB에서 MySQL 동등 제품으로 마이그레이션하는 것을 권장합니다.
• 중국어, 일본어, 한국어로 검색이 필요한 배포에는 MySQL 5.7.6+ 및 ngram 전체 텍스트 파서 구성이 필요합니다. 두 자 검색을 위해서는 ft_min_word_len 및 innodb_ft_min_token_size 를 2 로 설정하고 MySQL을 재시작해야 합니다. 자세한 내용은 CJK 토론을 참조하세요.

MySQL 8에서는 기본 콜레이션이 utf8mb4_0900_ai_ci 로 변경되었습니다(https://dev.mysql.com/doc/mysqld-version-reference/en/optvar-changes-8-0.html). 따라서 MySQL 설치를 버전 8로 업데이트하면 새 기본 콜레이션을 사용하도록 데이터베이스 테이블을 변환해야 합니다.

ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

이 변경 사항을 적용하지 않으면 데이터베이스의 테이블에 서로 다른 콜레이션이 생겨 쿼리 실행 시 오류가 발생할 수 있습니다.

MySQL 버전 8.0.0 - 8.0.11에서 ADMIN 은 예약 키워드이므로, MySQL 요구 사항이 버전 8.0.12인 이유입니다.

MySQL 8.0.22에는 문자열 값을 정수로 변경하는 JSON 칼럼 유형의 문제가 있어 Mattermost가 제대로 작동하지 않습니다. 이 데이터베이스 버전은 사용하지 않는 것을 권장합니다.

하드웨어 요구 사항#

CPU, RAM 및 스토리지 공간 사용량은 사용자 행동에 따라 크게 달라질 수 있습니다. 이 하드웨어 권장 사항은 전통적인 배포를 기반으로 하며, 사용자 활동 수준에 따라 늘거나 줄어들 수 있습니다.

또한 메모리 요구 사항은 최대 파일 공유 활동에 의해 결정될 수 있습니다. 권장 사항은 기본 최대 파일 크기 50MB를 기반으로 하며, System Console에서 조정할 수 있습니다. 이 숫자를 변경하면 메모리 요구 사항이 변경될 수 있습니다.

2,000명을 초과하는 사용자를 위한 배포의 경우 Mattermost 오픈 소스 부하 테스트 프레임워크를 사용하여 전체 규모로 시스템 사용량을 시뮬레이션하는 것을 권장합니다: https://github.com/mattermost/mattermost-load-test-ng.

Mattermost는 모든 64비트 x86 프로세서 아키텍처를 지원합니다.

팀 배포를 위한 하드웨어 요구 사항#

대부분의 소규모 및 중규모 Mattermost 팀 배포는 등록된 사용자 수에 따라 다음 사양의 단일 서버에서 지원될 수 있습니다.

• 1 - 1,000명 사용자 - vCPU/코어 1개, RAM 2GB
• 1,000 - 2,000명 사용자 - vCPU/코어 2개, RAM 4GB

엔터프라이즈 배포(다중 서버)를 위한 하드웨어 요구 사항#

확장 요구 사항#

다중 서버 설정을 갖춘 Enterprise Edition 배포의 경우 확장 가이드를 참조하세요.

조직의 특정 요구 사항을 기반으로 전체 규모 사용량을 추정하기 위해, 엔터프라이즈 전체 배포 전에 파일럿을 실행하는 것을 강력히 권장합니다. Mattermost 오픈 소스 부하 테스트 프레임워크를 사용하여 시스템 사용량을 시뮬레이션할 수 있습니다: https://github.com/mattermost/mattermost-load-test-ng.

Mattermost의 성능 모니터링 도구는 상세한 성능 측정에 사용하거나, 실행 중인 시스템을 검사하여 크기 조정과 설치가 올바른지 확인하는 데 사용할 수 있습니다.

시스템 요구 사항#

다중 서버 설정을 갖춘 Enterprise Edition 배포의 경우 Mattermost 배포를 지원하기 위해 다음 시스템을 강력히 권장합니다.

• Mattermost Enterprise에서 사용할 수 있는 성능 모니터링 기능을 통해 Mattermost 배포의 시스템 상태를 추적하는 Prometheus.
• 성능 모니터링 기능으로 Prometheus가 수집한 시스템 상태 메트릭을 시각화하는 Grafana. Grafana 5.0.0 이상을 권장합니다.
• 클러스터 환경에서 매우 효율적인 데이터베이스 검색을 지원하는 Elasticsearch. Elasticsearch v8.x 및 v9.x가 지원되며, Elasticsearch v9.x 또는 AWS OpenSearch를 권장합니다. Mattermost Server v12.0부터 OpenSearch v2.x가 지원되는 최소 버전이며, OpenSearch v1.x는 더 이상 지원되는 검색 백엔드가 아닙니다. 자세히 알아보기.
• AWS S3 또는 모든 S3 호환 서비스. Mattermost는 S3 API를 구현하는 객체 스토리지 시스템과 호환됩니다. 또한 NFS를 사용하는 로컬 스토리지나 네트워크 드라이브를 사용할 수 있습니다. 파일 스토리지 구성 옵션에 대해서는 문서에서 자세히 알아보세요.