소프트웨어 및 하드웨어 요구 사항

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

배포 개요

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

소프트웨어 요구 사항

클라이언트 소프트웨어

데스크톱 앱

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

Flatpak 패키지 요구 사항(Linux)

Mattermost Desktop v6.1부터 Linux용 Flatpak 패키지를 제공합니다(현재 베타). 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, Debian Buster, CentOS 6+, CentOS 7+, Red Hat Enterprise Linux 7+, Oracle Linux 6+, Oracle Linux 7+.
• Docker 호환 운영 체제(Linux 기반 OS)에서 Mattermost Docker 배포를 사용하는 방식도 여전히 권장합니다.

Fedora, FreeBSD, Arch Linux에 대해서는 커뮤니티 지원이 있지만, Mattermost는 현재 이 플랫폼들에 대한 프로덕션 지원을 제공하지 않습니다.

데이터베이스 소프트웨어

• PostgreSQL 14.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 전문가에게 문의하세요.

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

공통 제한 사항:

• 훨씬 큰 파일도 업로드할 수 있지만, 파일 내용은 앞부분 1 MB까지만 검색할 수 있습니다.

PostgreSQL에서의 검색 제한 사항:

• 이메일 주소는 결과를 반환하지 않습니다.
• 대시(-)가 포함된 해시태그나 최근 사용자 이름 멘션은 검색 결과를 반환하지 않습니다.
• 검색 쿼리에서 대시가 무시되므로 대시가 포함된 검색어는 잘못된 결과를 반환합니다.

• PostgreSQL 자체의 제한 사항도 있습니다.

  • 그중 하나는 The length of a tsvector (lexemes + positions) must be less than 1 megabyte입니다. 즉 파일 내용에 따라 1 MB 미만인 파일이라도 tsvector의 1 MB 한계에 도달하면 검색할 수 없습니다.
• 위 사항이 문제가 된다면 Enterprise 검색을 설정하고 활성화할 수 있습니다.

MySQL 지원

MySQL 데이터베이스 지원은 Mattermost v11부터 지원 중단이 시작됩니다. MySQL에서 PostgreSQL로 마이그레이션하는 방법은 PostgreSQL 마이그레이션 문서를 참고하세요.

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

MySQL 8.0.4에서 기본 인증 플러그인이 mysql_native_password에서 caching_sha2_password로 변경되었습니다. 따라서 MySQL 구성 파일에 다음 항목을 추가해 mysql_native_password를 활성화해야 합니다.

[mysqld]
default-authentication-plugin=mysql_native_password

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이 예약어이며, 이 때문에 Mattermost의 MySQL 요구 버전은 8.0.12입니다.

MySQL 8.0.22에는 문자열 값을 정수로 바꾸는 JSON 컬럼 타입 관련 문제가 있어 Mattermost가 정상적으로 동작하지 못합니다. 이 데이터베이스 버전은 사용하지 않는 것을 권장합니다.

하드웨어 요구 사항

CPU, RAM, 저장 공간 사용량은 사용자 행동에 따라 크게 달라질 수 있습니다. 여기서 제시하는 하드웨어 권장 사양은 일반적인 배포를 기준으로 하며, 사용자 활동 수준에 따라 늘거나 줄 수 있습니다.

또한 메모리 요구 사항은 파일 공유가 몰리는 시점에 따라 좌우될 수 있습니다. 권장 사양은 기본값인 최대 파일 크기 50 MB를 기준으로 하며, 이 값은 시스템 콘솔에서 조정할 수 있습니다. 이 값을 변경하면 메모리 요구 사항도 달라질 수 있습니다.

2,000명을 넘는 규모의 배포라면 Mattermost 오픈 소스 부하 테스트 프레임워크를 사용해 전체 규모에서의 시스템 사용을 시뮬레이션하는 것을 권장합니다: https://github.com/mattermost/mattermost-load-test-ng.

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

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

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

• 1 ~ 1,000명 - 1 vCPU/코어, 2 GB RAM
• 1,000 ~ 2,000명 - 2 vCPU/코어, 4 GB RAM

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

확장 요구 사항

다중 서버 구성의 Enterprise Edition 배포에 대해서는 Mattermost 확장 가이드를 참고하세요.

조직 고유의 요구에 기반해 전체 규모의 사용량을 추정할 수 있도록, 전사 배포에 앞서 파일럿을 진행하는 것을 강력히 권장합니다. Mattermost 오픈 소스 부하 테스트 프레임워크로 시스템 사용을 시뮬레이션할 수 있습니다: https://github.com/mattermost/mattermost-load-test-ng.

Mattermost의 성능 모니터링 도구를 사용하면 상세한 성능 측정과 실행 중인 시스템 점검을 통해 사양 산정과 설치가 올바른지 확인할 수 있습니다.

시스템 요구 사항

다중 서버 구성의 Enterprise Edition 배포에는 다음 시스템을 함께 사용하는 것을 강력히 권장합니다.

• Mattermost Enterprise에서 제공하는 성능 모니터링 기능을 통해 Mattermost 배포의 시스템 상태를 추적하는 Prometheus.
• 성능 모니터링 기능으로 Prometheus가 수집한 시스템 상태 지표를 시각화하는 Grafana. Grafana 5.0.0 이상을 권장합니다.
• 클러스터 환경에서 효율적인 데이터베이스 검색을 지원하는 Elasticsearch. Elasticsearch v8.x와 v9.x를 지원하며, Elasticsearch v9.x 또는 AWS OpenSearch를 권장합니다. 자세히 알아보기.
• AWS S3 또는 S3 호환 서비스. Mattermost는 S3 API를 구현한 오브젝트 스토리지 시스템과 호환됩니다. 로컬 저장소나 NFS를 사용하는 네트워크 드라이브도 사용할 수 있습니다. 파일 저장소 구성 옵션은 문서에서 자세히 확인하세요.