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

plans-img 모든 플랜 에서 사용 가능

deployment-img 자체 호스팅 배포

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

배포 개요#

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

소프트웨어 요구사항#

클라이언트 소프트웨어#

데스크톱 앱#

운영체제

자체 호스팅 기술 요구사항

클라우드 기술 요구사항

Windows

Windows 10+

Windows 10+

Mac

macOS 12+

macOS 12+

Linux

Ubuntu LTS 22.04 이상 버전

Ubuntu LTS 22.04 이상 버전

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

참고

  • * Mattermost 데스크톱 앱은 통합 Windows 인증을 지원하지 않습니다. ADFS를 사용하는 경우 WIA를 지원하지 않는 장치에 대해 인트라넷 양식 기반 인증 구성 을 권장합니다.

  • 최소 콘텐츠 크기는 769 x 600 픽셀입니다. 너비가 768 픽셀 이하일 때 데스크톱 앱은 모바일 보기로 전환됩니다. 높이가 600 픽셀 미만일 때 화면 요소가 잘못 배치될 수 있습니다.

PC 웹#

브라우저

자체 호스팅 기술 요구사항

클라우드 기술 요구사항

Chrome

v132+

v132+

Firefox

v119+

v119+

Safari

v17.4+

v17.4+

Edge

v132+

v132+

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

모바일 앱#

운영체제

기술 요구사항

iOS

iOS 15.1+ 이상이 설치된 iPhone 6s 이상 기기

Android

Android 7+ 이상이 설치된 Android 기기

참고

  • * Mattermost 모바일 앱은 통합 Windows 인증을 지원하지 않습니다. ADFS를 사용하는 경우 WIA를 지원하지 않는 장치에 대해 인트라넷 양식 기반 인증 구성 을 권장합니다.

  • 최소 및 목표 콘텐츠 크기는 320 x 460 픽셀로, 지원되는 최소 iOS 기기에서 Safari로 모바일 앱을 열었을 때의 가용 공간과 일치합니다.

모바일 웹#

브라우저

기술 요구사항

iOS

Safari 17.4+ 또는 Chrome 132+가 설치된 iOS 15.1+

Android

Chrome 132+가 설치된 Android 7+

이메일 클라이언트#

  • 데스크톱 클라이언트: Outlook 2010+, Apple Mail 버전 7+, Thunderbird 38.2+

  • 웹 기반 클라이언트: Entra ID, Outlook, Gmail, Yahoo, AOL

  • Mobile clients: iOS Mail App (iOS 7+), Gmail Mobile App (Android, iOS)

서버 소프트웨어#

Mattermost 서버 운영체제#

  • Ubuntu, Debian Buster, CentOS 6+, CentOS 7+, RedHat Enterprise Linux 7+, Oracle Linux 6+, Oracle Linux 7+.

  • Docker 호환 운영체제(Linux 기반 OS)에서 Mattermost Docker 배포 를 사용하는 것이 여전히 권장됩니다.

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

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

  • PostgreSQL 13.0+

  • MySQL 8.0.12+ (MySQL 8 지원에 대한 참고사항은 아래 참조)

PostgreSQL과 MySQL의 Amazon Aurora 동등 버전도 지원됩니다.

중요

  • MariaDB v10+는 더 이상 MySQL 드롭인 대체제로 작동하지 않으며, MySQL 5.7.12 요구사항으로 인해 Mattermost에서 지원되지 않습니다. 이전 버전의 MariaDB는 공식적으로 지원되지 않았지만 이전 Mattermost 릴리스에서 작동했을 수 있습니다. 현재 MariaDB를 실행 중이라면 MariaDB에서 MySQL 동등 버전으로 마이그레이션하는 것이 권장됩니다.

  • 중국어, 일본어, 한국어 검색이 필요한 배포에는 MySQL 5.7.6+와 ngram Full-Text parser 구성이 필요합니다. 두 글자 검색을 위해서는 ft_min_word_len 과 innodb_ft_min_token_size``를 ``2 로 설정하고 MySQL을 재시작해야 합니다. 자세한 내용은 CJK 논의 를 참조하세요.

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

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

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

참고

Mattermost v10.6은 Extended Support Release (ESR) 가 아닙니다. 앞으로 이 데이터베이스 버전 지원 정책은 ESR 릴리스에만 적용됩니다.

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

Mattermost 버전

릴리스 날짜

최소 PostgreSQL 버전

v9.11 ESR

2024-8-15

11.x

v10.5 ESR

2025-2-15

11.x

v10.6

2025-3-15

13.x

v10.11 ESR

2025-8-15

13.x

v11.5 ESR *

2026-2-15

14.x (EOL 2026-11-12)

* 예상 릴리스 버전 및 날짜입니다.

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

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

일반적인 제한사항:

  • 더 큰 파일을 업로드할 수 있더라도 파일 내용의 초기 1 MB 만 검색에 사용할 수 있습니다.

PostgreSQL의 검색 제한사항:

  • 이메일 주소는 검색 결과를 반환하지 않습니다.

  • 대시가 포함된 해시태그나 최근 사용자 이름 멘션은 검색 결과를 반환하지 않습니다.

  • 대시가 포함된 용어는 검색 쿼리에서 대시가 무시되므로 잘못된 결과를 반환합니다.

  • PostgreSQL 자체 에서 설정한 제한사항:

    • 그 중 하나는: tsvector(어휘소 + 위치)의 길이는 1메가바이트보다 작아야 합니다, 이는 파일 내용에 따라 1 MB 미만의 파일도 tsvector 1 MB 제한에 도달하면 검색할 수 없음을 의미합니다.

  • 위의 사항 중 하나라도 문제가 있다면, Elasticsearch 기능 을 활성화하거나 MySQL을 설치할 수 있습니다.

MySQL의 검색 제한사항:

  • 점이 포함된 해시태그나 최근 사용자 이름 멘션은 검색 결과를 반환하지 않습니다.

  • 마이그레이션 시스템은 스키마 마이그레이션을 실행하기 위해 MySQL 데이터베이스 사용자가 추가 EXECUTE, CREATE ROUTINE, ALTER ROUTINE 및 REFERENCES 권한을 가져야 합니다.

MySQL 8 지원#

중요

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

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 은 예약 키워드 이므로, 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 오픈 소스 부하 테스트 프레임워크를 사용하여 시스템 사용을 시뮬레이션할 수 있습니다: https://github.com/mattermost/mattermost-load-test-ng.

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

시스템 요구사항#

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

  • Mattermost Enterprise에서 사용 가능한 성능 모니터링 기능 을 통해 Mattermost 배포의 시스템 상태를 추적하는 Prometheus

  • 성능 모니터링 기능 을 통해 Prometheus가 수집한 시스템 상태 메트릭을 시각화하는 Grafana. Grafana 5.0.0 이상을 권장합니다.

  • 클러스터 환경에서 고효율 데이터베이스 검색을 지원하는 Elasticsearch. Elasticsearch v7.17+가 지원되며, Mattermost v9.11부터는 Elasticsearch v8.x 또는 Opensource를 권장합니다. 자세한 내용은 여기 를 참조하세요.

  • MinIO 또는 AWS S3. Mattermost는 S3 API를 구현하는 객체 스토리지 시스템과 호환됩니다. 다른 S3 호환 시스템도 작동할 수 있지만 공식적으로 지원되지 않습니다. 파일 스토리지 구성 옵션에 대한 자세한 내용은 문서 를 참조하세요.