실험적 구성 설정

Mattermost v11.11번역일: 2026-09-02원본 보기

Entry, Professional, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.

시스템 콘솔(System Console)에서 Product 제품 메뉴 아이콘 메뉴를 선택하고 System Console, Experimental > Features를 차례로 선택해 다음 실험적 구성 옵션을 확인하고 관리하세요.

팁

자체 호스팅 Mattermost 배포를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 아래의 각 구성 값에는 JSON을 다룰 수 있는 도구로 config.json 파일에서 해당 값에 프로그래밍 방식으로 접근할 수 있는 JSON 경로가 함께 표시됩니다. 예를 들어 LoginButtonColor 값 중 하나는 LdapSettings 아래에 있습니다.

  • jq 같은 도구를 사용한다면 다음과 같이 입력합니다: cat config/config.json | jq '.LdapSettings.LoginButtonColor'
  • config.json 파일을 직접 편집할 때는 LdapSettings 같은 객체를 찾은 뒤 그 객체 안에서 LoginButtonColor 키를 찾습니다.

실험적 시스템 콘솔 구성 설정

AD/LDAP 로그인 버튼 색상 (AD/LDAP login button color)

화이트 라벨링 목적으로 AD/LDAP 로그인 버튼의 색상을 지정합니다. 코드 앞에 #을 붙인 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 "LoginButtonColor": ""이며 문자열을 입력합니다.

AD/LDAP 로그인 버튼 테두리 색상 (AD/LDAP login button border color)

화이트 라벨링 목적으로 AD/LDAP 로그인 버튼 테두리의 색상을 지정합니다. 코드 앞에 #을 붙인 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 "LoginButtonBorderColor": ""이며 문자열을 입력합니다.

AD/LDAP 로그인 버튼 텍스트 색상 (AD/LDAP login button text color)

화이트 라벨링 목적으로 AD/LDAP 로그인 버튼 텍스트의 색상을 지정합니다. 코드 앞에 #을 붙인 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 "LoginButtonTextColor": ""이며 문자열을 입력합니다.

인증 방식 변경 (Change authentication method)

True: 사용자가 프로필 또는 API를 통해 서버에서 활성화된 로그인 방식으로 자신의 로그인 방식을 변경할 수 있습니다.

False: 어떤 인증 옵션이 활성화되어 있든 사용자가 로그인 방식을 변경할 수 없습니다.

이 기능의 config.json 설정은 "ExperimentalEnableAuthenticationTransfer": true이며 옵션은 true와 false입니다.

링크 메타데이터를 가져오는 요청에 대해 제한 시간을 설정할 수 있게 합니다. 이 제한 시간이 지나도 메타데이터가 반환되지 않으면 메타데이터 없이 메시지가 게시됩니다. 이 제한 시간은 느린 네트워크 연결에서 깨진 URL이나 잘못된 콘텐츠 유형으로 인한 실패 상황을 처리합니다.

이 기능의 config.json 설정은 "LinkMetadataTimeoutMilliseconds: 5000``이며 숫자를 입력합니다.

이메일 배치 버퍼 크기 (Email batching buffer size)

하나의 이메일로 묶을 알림의 최대 개수를 지정합니다.

참고
  • Mattermost 로그에 다음 오류가 보인다면 버퍼 크기를 기본값보다 늘리는 것을 권장합니다: Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail. 이 값을 늘리면 서버 성능에 영향을 주지 않으면서 이메일이 큐에 쌓이도록 할 수 있습니다.
  • 이메일 큐가 설정된 이메일 배치 간격을 초과하면 알림이 즉시 발송됩니다.

이 기능의 config.json 설정은 EmailBatchingBufferSize: 256``이며 숫자를 입력합니다.

이메일 배치 간격 (Email batching interval)

배치 작업이 새 알림을 확인하는 최대 주기를 초 단위로 지정합니다.

참고
  • Mattermost 로그에 다음 오류가 보인다면 이메일 배치 간격을 기본값보다 줄이는 것을 권장합니다: Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail.
  • 배치 간격을 길게 잡으면 성능이 향상될 수 있습니다.
  • 이메일 큐가 설정된 이메일 배치 간격을 초과하면 알림이 즉시 발송됩니다.

이 기능의 config.json 설정은 EmailBatchingInterval": 30이며 숫자를 입력합니다.

이메일 로그인 버튼 색상 (Email login button color)

화이트 라벨링 목적으로 이메일 로그인 버튼의 색상을 지정합니다. 코드 앞에 #을 붙인 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 "LoginButtonColor": ""이며 문자열을 입력합니다.

이메일 로그인 버튼 테두리 색상 (Email login button border color)

화이트 라벨링 목적으로 이메일 로그인 버튼 테두리의 색상을 지정합니다. 코드 앞에 #을 붙인 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 "LoginButtonBorderColor": ""이며 문자열을 입력합니다.

이메일 로그인 버튼 텍스트 색상 (Email login button text color)

화이트 라벨링 목적으로 이메일 로그인 버튼 텍스트의 색상을 지정합니다. 코드 앞에 #을 붙인 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 "LoginButtonTextColor": ""이며 문자열을 입력합니다.

계정 비활성화 활성화 (Enable account deactivation)

True: 사용자가 Settings > Advanced > Deactivate Account에서 자신의 계정을 비활성화할 수 있습니다. 사용자가 자신의 계정을 비활성화하면 비활성화되었음을 알리는 이메일 알림을 받습니다. 인증이 이메일/비밀번호 방식으로 설정된 경우에만 사용할 수 있으며, SAML이나 AD/LDAP 인증을 사용할 때는 사용할 수 없습니다.

False: 사용자가 자신의 계정을 비활성화하는 기능이 비활성화됩니다.

이 기능의 config.json 설정은 "EnableUserDeactivation": false이며 옵션은 true와 false입니다.

자동 회신 활성화 (Enable automatic replies)

True: 사용자가 Settings > Notifications에서 자동 회신을 활성화할 수 있습니다. 사용자는 다이렉트 메시지에 자동으로 발송될 맞춤 메시지를 설정합니다.

False: 다이렉트 메시지 자동 회신 기능을 비활성화하고 Settings에서 숨깁니다.

이 기능의 config.json 설정은 "ExperimentalEnableAutomaticReplies": false이며 옵션은 true와 false입니다.

채널 조회 웹소켓 메시지 활성화 (Enable channel viewed websocket messages)

이 설정은 클라이언트와 기기 간에 읽지 않음 알림을 동기화하는 channel_viewed WebSocket 이벤트를 전송할지 결정합니다.

이 기능의 config.json 설정은 "EnableChannelViewedMessages": true이며 옵션은 true와 false입니다.

참고

대규모 배포에서 이 실험적 구성 설정을 비활성화하면 다음 영역에서 서버 성능이 향상될 수 있습니다.

  • 데이터베이스 부하 감소: channel_viewed 이벤트를 비활성화하면 서버가 이 이벤트를 데이터베이스에 기록할 필요가 없어집니다. 이는 쓰기 및 갱신 작업 수를 줄여 주며, 많은 사용자가 채널을 자주 전환하는 바쁜 서버에서는 그 효과가 상당할 수 있습니다.
  • 네트워크 트래픽 감소: 이 이벤트를 비활성화하면 서버와 클라이언트 사이에 오가는 메시지가 줄어듭니다. 네트워크 트래픽이 줄면 지연 시간이 낮아지고 서버의 전반적인 응답성이 향상되며, 특히 연결 속도가 느린 사용자에게 도움이 됩니다.
  • 서버 CPU 사용량 감소: channel_viewed 이벤트 처리에는 데이터베이스 트랜잭션과 네트워크 통신을 다루기 위한 CPU 자원이 필요합니다. 이 이벤트가 없으면 서버 CPU를 다른 작업에 더 효율적으로 사용할 수 있어 전반적인 성능이 향상됩니다.
  • 사용자 경험 향상: 서버 부하와 네트워크 트래픽이 줄어들면 사용자는 더 빠른 로딩 시간과 더 매끄러운 상호작용을 경험할 수 있습니다.
  • 다만 이 구성 설정을 비활성화하면 채널에서 읽은 메시지와 읽지 않은 메시지를 정확히 추적하는 등 일부 기능에 영향을 줍니다. 성능 향상과 조직 및 사용자의 필요 사이에서 균형을 잡는 것이 중요합니다.

기본 채널 나가기/참여 시스템 메시지 활성화 (Enable default channel leave/join system messages)

이 설정은 팀 나가기/참여 시스템 메시지를 기본 town-square 채널에 게시할지 결정합니다.

True: 기본 town-square 채널에서 나가기/참여 시스템 메시지를 활성화합니다.

False: 기본 town-square 채널에서 나가기/참여 메시지를 비활성화합니다. 이 시스템 메시지는 데이터베이스에도 추가되지 않습니다.

이 기능의 config.json 설정은 "ExperimentalEnableDefaultChannelLeaveJoinMessages": true이며 옵션은 true와 false입니다.

강화 모드 활성화 (Enable hardened mode)

True: 보안을 위해 사용자 경험을 일부 희생하는 Mattermost 강화 모드를 활성화합니다.

False: 강화 모드를 비활성화합니다.

강화 모드를 활성화하면 다음이 달라집니다.

  • 로그인 실패 시 사용자 이름과 비밀번호에 대한 구체적인 메시지 대신 일반적인 오류 메시지가 반환됩니다.
  • 다중 인증(MFA)이 활성화된 경우, 사용자의 MFA 활성화 여부를 확인하는 경로가 항상 true를 반환합니다. 이로 인해 사용자가 MFA를 활성화하지 않았더라도 MFA 입력 화면이 표시됩니다. 사용자는 아무 값이나 입력해 이 화면을 넘어갈 수 있습니다. MFA가 강제되는 경우에는 강화 모드가 사용자 경험에 영향을 주지 않습니다.
  • 비밀번호 재설정 시 SSO 계정은 Mattermost를 통해 재설정할 수 없다는 사실을 사용자에게 알리지 않고, 비밀번호 재설정 이메일을 보냈다고 표시합니다.
  • Mattermost는 모든 500 오류를 클라이언트에 반환하기 전에 정제합니다. 제공되는 request_id를 사용해 사용자에게 표시된 오류와 서버 로그를 대조하세요.
  • 사용자 이름과 비밀번호로 인증한 일반 사용자는 override_username이나 override_icon_url 같이 연동을 위해 예약된 게시물 속성을 사용할 수 없습니다.

이 기능의 config.json 설정은 "ExperimentalEnableHardenedMode": false이며 옵션은 true와 false입니다.

모바일 워터마크 활성화 (Enable Mobile Watermark)

Mattermost v11.7부터 Enterprise Advanced에서 사용할 수 있습니다.

True: 인증된 Mattermost 모바일 세션에 사용자 이름, 서버 도메인, 현재 날짜(YYYY-MM-DD), 현재 시각(HH:mm)을 표시하는 워터마크 오버레이가 나타납니다. 이 실험적 기능은 모바일 스크린샷이나 공유된 화면 캡처와 연관된 사용자, 서버, 시각을 식별할 수 있게 해 데이터 유출 방지(DLP) 워크플로를 지원하기 위한 것입니다.

False: Mattermost 모바일 앱에 워터마크 오버레이가 표시되지 않습니다.

참고
  • 이 설정은 실험적 기능입니다. 동작, 기본값, 시각적 표현은 향후 릴리스에서 바뀔 수 있습니다.
  • 이 설정은 Mattermost 모바일 앱에만 적용됩니다. Mattermost 웹 앱이나 데스크톱 앱에는 워터마크가 추가되지 않습니다.
  • 워터마크 오버레이는 시각적 보조 수단이며, 그 자체로 스크린샷, 화면 녹화, 파일 내보내기 등의 데이터 유출을 막지는 못합니다. 필요하다면 스크린샷 및 화면 녹화 방지 같은 다른 모바일 보안 제어와 함께 사용하세요.

이 기능의 config.json 설정은 "ExperimentalSettings.EnableMobileWatermark": false이며 옵션은 true와 false입니다

테마 선택 활성화 (Enable theme selection)

True: Settings의 Display > Theme 탭을 활성화해 사용자가 테마를 선택할 수 있게 합니다.

False: 사용자가 다른 테마를 선택할 수 없습니다. Settings에서 Display > Theme 탭이 숨겨집니다.

이 기능의 config.json 설정은 "EnableThemeSelection": true이며 옵션은 true와 false입니다.

커스텀 테마 허용 (Allow custom themes)

True: Settings의 Display > Theme > Custom Theme 섹션을 활성화합니다.

False: 사용자가 커스텀 테마를 사용할 수 없습니다. Settings에서 Display > Theme > Custom Theme 섹션이 숨겨집니다.

이 기능의 config.json 설정은 "AllowCustomThemes": true이며 옵션은 true와 false입니다.

기본 테마 (Default theme)

시스템의 모든 신규 사용자에게 적용될 기본 테마를 설정합니다.

이 기능의 config.json 설정은 "DefaultTheme": "default"이며 옵션은 "default", "organization", "mattermostDark", "windows10"입니다.

튜토리얼 활성화 (Enable tutorial)

True: 계정 생성 후 Mattermost를 처음 열 때 사용자에게 튜토리얼이 표시됩니다.

False: 튜토리얼이 비활성화됩니다. 사용자는 계정 생성 후 Mattermost를 처음 열 때 Town Square로 이동합니다.

이 기능의 config.json 설정은 "ServiceSettings.EnableTutorial": true이며 옵션은 true와 false입니다.

온보딩 플로 활성화 (Enable onboarding flow)

True: 신규 Mattermost 사용자에게 초기 온보딩의 일부로 완료할 주요 작업이 표시됩니다.

False: 사용자 온보딩 작업이 비활성화됩니다. 사용자는 계정 생성 후 Mattermost를 처음 열 때 Town Square로 이동합니다.

이 기능의 config.json 설정은 "ServiceSettings.EnableOnboardingFlow": true이며 옵션은 true와 false입니다.

입력 중 메시지 활성화 (Enable user typing messages)

이 설정은 웹 브라우저나 데스크톱 앱에서 Mattermost를 사용할 때 메시지 입력란 아래에 "user is typing..." 메시지를 표시할지 결정합니다.

이 기능의 config.json 설정은 "EnableUserTypingMessages": true이며 옵션은 true와 false입니다.

참고

대규모 배포에서 이 실험적 구성 설정을 비활성화하면 다음 영역에서 서버 성능이 향상될 수 있습니다.

  • 서버 부하 감소: 입력 중 이벤트는 추가 웹소켓 트래픽을 발생시킵니다. 이를 비활성화하면 서버가 처리해야 하는 데이터양이 줄어 전반적인 응답 시간이 개선되고 서버 부하가 낮아집니다.
  • 네트워크 트래픽 감소: 입력 중 이벤트가 활성화되어 있으면 키를 누를 때마다 네트워크 이벤트가 발생합니다. 특히 활동이 많은 채널에서는 상당한 네트워크 트래픽이 생길 수 있습니다. 이 이벤트를 비활성화하면 네트워크로 전송되는 정보량이 줄어듭니다.
  • 클라이언트 성능: 클라이언트 측에서도 입력 중 이벤트를 처리하는 데 자원이 필요합니다. 이 이벤트를 처리하지 않으면 클라이언트의 응답성이 좋아지고 메모리와 CPU 사용량이 줄어듭니다.

입력 중 표시 제한 시간 (User typing timeout)

이 설정은 "user is typing..." 메시지를 갱신하는 주기를 밀리초 단위로 정의합니다.

이 기능의 config.json 설정은 "TimeBetweenUserTypingUpdatesMilliseconds": 5000이며 숫자를 입력합니다.

사용자 상태 및 프로필 조회 폴링 간격 (User's status and profile fetching poll interval)

이 설정은 사용자 상태와 프로필을 주기적으로 가져오는 사이의 대기 시간을 밀리초 단위로 구성합니다. 0으로 설정하면 비활성화됩니다.

이 기능의 config.json 설정은 "ExperimentalSettings.UsersStatusAndProfileFetchingPollIntervalMilliseconds": 3000이며 숫자를 입력합니다.

참고

이 구성 설정의 값을 줄이면 Mattermost가 갱신된 사용자 프로필 정보를 더 자주 확인하고 가져옵니다. 이 값을 줄이면 데이터가 오래되었거나 누락되어 채널에서 사용자 이름이 Someone으로 표시되는 상황을 줄이는 데 특히 도움이 됩니다.

기본 팀 (Primary team)

서버의 사용자가 소속되는 기본 팀입니다. 기본 팀이 설정되면 다른 팀에 참여하거나 기본 팀을 나가는 옵션이 비활성화됩니다.

기본 팀의 팀 URL이 https://example.mattermost.com/myteam/이라면 config.json에 값을 myteam으로 설정합니다.

이 기능의 config.json 설정은 "ExperimentalPrimaryTeam": ""이며 문자열을 입력합니다.

SAML 로그인 버튼 색상 (SAML login button color)

화이트 라벨링 목적으로 SAML 로그인 버튼의 색상을 지정합니다. 코드 앞에 #을 붙인 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 "LoginButtonColor": ""이며 문자열을 입력합니다.

SAML 로그인 버튼 테두리 색상 (SAML login button border color)

화이트 라벨링 목적으로 SAML 로그인 버튼 테두리의 색상을 지정합니다. 코드 앞에 #을 붙인 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 "LoginButtonBorderColor": ""이며 문자열을 입력합니다.

SAML 로그인 버튼 텍스트 색상 (SAML login button text color)

화이트 라벨링 목적으로 SAML 로그인 버튼 텍스트의 색상을 지정합니다. 코드 앞에 #을 붙인 16진수 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

이 기능의 config.json 설정은 "LoginButtonTextColor": ""이며 문자열을 입력합니다.

이메일 알림에 채널 이름 사용 (Use channel name in email notifications)

True: 이메일 알림 제목에 채널 이름과 팀 이름이 표시됩니다. 팀을 하나만 사용하는 서버에 유용합니다.

False: 이메일 알림 제목에 팀 이름만 표시됩니다.

이 기능의 config.json 설정은 "UseChannelInEmailNotifications": false이며 옵션은 true와 false입니다.

자리 비움 상태 전환 시간 (User status away timeout)

이 설정은 사용자가 Mattermost에서 활동하지 않을 때 상태 표시가 "Away"로 바뀌기까지의 시간을 초 단위로 정의합니다.

이 기능의 config.json 설정은 "UserStatusAwayTimeout": 300이며 숫자를 입력합니다.

브라우저 재포커스 시 데이터 재조회 비활성화 (Disable data refetching on browser refocus)

이 설정은 브라우저에 포커스가 돌아올 때 채널과 채널 구성원을 다시 가져오는 동작을 비활성화합니다.

True: 브라우저에 포커스가 돌아와도 Mattermost가 채널과 채널 구성원을 다시 가져오지 않습니다. 채널과 채널 구성원이 많은 사용자에게는 성능이 향상될 수 있습니다.

False: (기본값) 브라우저에 포커스가 돌아오면 Mattermost가 채널과 채널 구성원을 다시 가져옵니다.

이 기능의 config.json 설정은 "ExperimentalSettings.DisableRefetchingOnBrowserFocus": false이며 옵션은 true와 false입니다.

절전 해제 재연결 핸들러 비활성화 (Disable wake up reconnect handler)

이 설정은 컴퓨터가 절전에서 깨어난 시점을 감지해 데이터를 다시 가져오려는 시도를 비활성화합니다.

True: Mattermost가 컴퓨터의 절전 해제를 감지해 데이터를 다시 가져오려 시도하지 않습니다. 앱이 보내는 정기적인 네트워크 트래픽이 줄어들 수 있습니다.

False: (기본값) Mattermost가 컴퓨터의 절전 해제를 감지해 데이터를 새로 고칩니다.

이 기능의 config.json 설정은 "ExperimentalSettings.DisableWakeUpReconnectHandler": false이며 옵션은 true와 false입니다.

채널 자동 완성 지연 (Delay channel autocomplete)

이 설정은 메시지를 작성할 때 물결표를 입력하는 즉시 채널 링크 자동 완성이 뜨는지 여부를 제어합니다. 이 설정을 사용하면 물결표 ~를 문장 부호로 쓰는 사용자에게 ~town-square 같은 채널 자동 완성이 덜 거슬리게 됩니다.

True: 사용자가 물결표에 이어 두 글자 이상을 입력한 뒤에 자동 완성이 나타납니다. 예를 들어 ~to를 입력하면 자동 완성이 표시되지만 ~만 입력하면 표시되지 않습니다.

False: (기본값) 사용자가 물결표를 입력하는 즉시 자동 완성이 나타납니다. 예를 들어 ~만 입력해도 자동 완성이 표시됩니다.

이 기능의 config.json 설정은 "ExperimentalSettings.DelayChannelAutocomplete": false이며 옵션은 true와 false입니다.

YouTube 리퍼러 정책 (YouTube referrer policy)

이 설정은 YouTube 동영상 미리보기가 사용할 수 없음으로 표시되는 문제를 해결합니다.

True: 임베드된 YouTube 동영상의 리퍼러 정책이 strict-origin-when-cross-origin으로 설정됩니다.

False: (기본값) 리퍼러 정책이 no-referrer로 설정됩니다. 원본 URL을 노출하지 않아 사용자 프라이버시를 강화하지만, 분석 도구에서 사용자 참여와 트래픽 출처를 추적하는 기능은 제한됩니다.

이 기능의 config.json 설정은 "ExperimentalSettings.YoutubeReferrerPolicy": false이며 옵션은 true와 false입니다.

실험적 Bleve 구성 설정

Entry, Professional, Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.

중요

Mattermost v11부터 Bleve 검색은 사용 중단되었습니다. 이 구성 설정들은 v11.0 이전 Mattermost 버전에서만 사용할 수 있습니다. v11.0 이상에서는 엔터프라이즈 검색 기능을 위해 Elasticsearch 또는 OpenSearch를 사용하세요.

시스템 콘솔의 Experimental > Bleve에서 또는 아래 표에 설명된 대로 config.json 파일을 편집해 다음 구성 설정에 접근합니다.

Bleve 인덱싱 활성화 (Enable Bleve indexing)

True: 새 게시물의 인덱싱이 자동으로 이루어집니다. 검색 쿼리에 Bleve 사용을 활성화하기 전까지는 검색 쿼리에 bleve 검색이 사용되지 않습니다.

False: 새 게시물의 인덱싱이 자동으로 이루어지지 않습니다.

이 기능의 config.json 설정은 "EnableIndexing": false이며 옵션은 true와 false입니다.

인덱스 디렉터리 (Index directory)

bleve 인덱스를 저장할 디렉터리 경로입니다.

팁

bleve 인덱스 디렉터리 경로가 반드시 mattermost 디렉터리 안에 있어야 하는 것은 아닙니다. mattermost 디렉터리 밖에 있으면 Mattermost 업그레이드 시 이 파일들을 보존하거나 다시 인덱싱하기 위해 별도 작업을 할 필요가 없습니다. 자세한 내용은 Mattermost 서버 업그레이드 문서를 참고하세요.

이 기능의 config.json 설정은 "IndexDir": ""이며 문자열을 입력합니다.

지금 대량 인덱싱 (Bulk index now)

Index Now를 선택하면 데이터베이스의 모든 사용자, 채널, 게시물을 오래된 것부터 최신 순으로 인덱싱합니다. 인덱싱 중에도 Bleve를 사용할 수 있지만, 인덱싱 작업이 끝나기 전까지는 검색 결과가 불완전할 수 있습니다.

인덱스 제거 (Purge indexes)

Purge Index를 선택하면 Bleve 인덱스 디렉터리의 내용을 제거합니다. 기존 데이터베이스에 대한 대량 인덱싱을 다시 수행하기 전까지는 검색 결과가 불완전할 수 있습니다.

검색 쿼리에 Bleve 사용 (Enable Bleve for search queries)

True: 검색 쿼리에 bleve 검색을 사용합니다.

False: 검색 쿼리에 bleve 검색을 사용하지 않습니다.

이 기능의 config.json 설정은 "EnableSearching": false이며 옵션은 true와 false입니다.

자동 완성 쿼리에 Bleve 사용 (Enable Bleve for autocomplete queries)

True: 자동 완성 쿼리에 bleve 검색을 사용합니다.

False: 자동 완성 쿼리에 bleve 검색을 사용하지 않습니다.

이 기능의 config.json 설정은 "EnableAutocomplete": false이며 옵션은 true와 false입니다.

자체 호스팅 배포 전용 실험적 구성 설정

아래 표에 설명된 대로 config.json 파일을 편집해 다음 자체 호스팅 구성 설정에 접근합니다. 이 구성 설정들은 시스템 콘솔에서는 접근할 수 없습니다.

팁

아래의 각 구성 값에는 JSON을 다룰 수 있는 도구로 config.json 파일에서 해당 값에 프로그래밍 방식으로 접근할 수 있는 JSON 경로가 함께 표시됩니다. 예를 들어 SiteURL 값은 ServiceSettings 아래에 있습니다.

  • jq 같은 도구를 사용한다면 다음과 같이 입력합니다: cat config/config.json | jq '.ServiceSettings.SiteURL'
  • config.json 파일을 직접 편집할 때는 ServiceSettings 키를 찾은 뒤 그 객체 안에서 SiteURL 키를 찾습니다.

허용 테마 (Allowed themes)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

EnableThemeSelection이 true로 설정된 경우 사용자가 선택할 수 있는 테마를 지정합니다.

이 기능의 config.json 설정은 "AllowedThemes": []이며 "default", "organization", "mattermostDark", "windows10" 옵션으로 구성된 ["mattermostDark", "windows10"] 형태의 문자열 배열을 입력합니다.

파일 위치 (File Location)

Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

컴플라이언스 내보내기의 파일 위치를 설정합니다. 기본적으로 구성된 로컬 스토리지 디렉터리의 exports 하위 디렉터리에 기록됩니다.

이 기능의 config.json 설정은 "FileLocation": "export"이며 문자열을 입력합니다.

푸시 알림 버퍼 (Push notification buffer)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

발송 대기 중인 푸시 알림 메시지의 버퍼를 제어하는 데 사용합니다. 메시지 수가 이 값을 초과하면 푸시 알림을 만드는 요청은 여유가 생길 때까지 차단됩니다.

이 기능의 config.json 설정은 "PushNotificationBuffer": 1000"이며 숫자를 입력합니다.

시스템 관리자 제한 (Restrict system admin)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

True: (클라우드 배포의 기본값) 시스템 관리자가 시스템 콘솔에서 일부 서버 구성 설정을 조회하고 변경하지 못하도록 제한합니다. 온프레미스 설치 환경에서는 권장하지 않습니다. Mattermost Private Cloud에서 사용자에게 시스템 관리자 역할을 부여하되 특정 작업은 Cloud Admin으로만 제한하기 위한 설정입니다.

False: (자체 호스팅 배포의 기본값) 시스템 관리자 역할에 아무런 제한이 적용되지 않습니다.

이 기능의 config.json 설정은 "RestrictSystemAdmin": "false"이며 옵션은 true와 false입니다.

참고

시스템 관리자가 일부 서버 구성 설정을 조회하고 변경하지 못하도록 제한하는 기능은 현재 베타 단계입니다.

클라이언트 측 인증서 인증 활성화 (Enable client-side certification)

Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.

중요

인증서 기반 인증은 Mattermost v11.0부터 사용 중단되었습니다. v11부터 서버를 시작하려면 이 설정을 false로 두어야 합니다. true로 설정하면 서버가 시작되지 않습니다.

True: Mattermost 서버에서 클라이언트 측 인증서 인증을 활성화합니다. 자세한 내용은 관련 문서를 참고하세요.

False: (기본값) 클라이언트 측 인증서 인증이 비활성화됩니다.

이 기능의 config.json 설정은 "ClientSideCertEnable": false이며 옵션은 true와 false입니다.

클라이언트 측 인증서 로그인 방식 (Client-side certification login method)

Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.

중요

인증서 기반 인증은 Mattermost v11.0부터 사용 중단되었습니다. 이 설정은 Mattermost v11.0부터 동작하지 않으며 기본값으로 두어야 합니다.

이 구성 설정은 ClientSideCertEnable 구성 설정과 함께 사용하며 다음 값을 가질 수 있습니다.

Primary: 클라이언트 측 인증서가 검증된 뒤 인증서에서 사용자 이메일을 가져와 비밀번호 없이 로그인합니다.

Secondary: (기본값) 클라이언트 측 인증서가 검증된 뒤 인증서에서 사용자 이메일을 가져와 사용자가 입력한 이메일과 대조합니다. 일치하면 사용자는 일반적인 이메일/비밀번호 자격 증명으로 로그인합니다.

이 기능의 config.json 설정은 "ClientSideCertCheck": "secondary"이며 옵션은 "primary"와 "secondary"입니다.

내보내기 출력 디렉터리 (Export output directory)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

내보낸 파일이 저장되는 디렉터리입니다. 경로는 FileSettings 디렉터리를 기준으로 합니다. 기본적으로 내보내기 파일은 ./data/export 아래에 저장됩니다.

이 기능의 ExportSettings 섹션 아래 config.json 설정은 Directory: ./export이며 문자열을 입력합니다.

내보내기 보존 일수 (Export retention days)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

내보낸 파일을 삭제하기 전까지 보관할 일수입니다.

이 기능의 ExportSettings 섹션 아래 config.json 설정은 RetentionDays: 30이며 숫자를 입력합니다.

최대 이미지 해상도 (Maximum image resolution)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

메시지 첨부 이미지의 최대 해상도(픽셀)입니다.

이 기능의 config.json 설정은 "MaxImageResolution": 33177600이며 숫자를 입력합니다.

최대 이미지 디코더 동시 실행 수 (Maximum image decoder concurrency)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

동시에 디코딩할 수 있는 이미지의 개수를 지정합니다. 기본값 -1은 Mattermost가 사용 가능한 CPU 수를 자동으로 사용하도록 구성합니다.

참고
  • 이 구성 설정은 서버의 전체 메모리 사용량에 영향을 줍니다. 이미지 한 장의 최대 메모리는 MaxImageResolution * 24 bytes로 결정되며, 기본 최대 이미지 해상도 값은 33MB입니다.
  • 따라서 33MB * MaxImageDecoderConcurrency * 24가 서버의 전체 메모리보다 작아야 한다는 것을 기준으로 삼으면 좋습니다.
  • 예를 들어 4코어 서버라면 이미지 처리를 위해 최소 33 * 4 * 24 = 3168MB의 메모리를 남겨 두어야 합니다. 그렇지 않다면 MaxImageResolution 구성 설정을 조정해 이미지 처리에 필요한 메모리 양을 조절하세요.

이 기능의 config.json 설정은 "MaxImageDecoderConcurrency": "-1"이며 숫자를 입력합니다.

이니셜 폰트 (Initial font)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

배경색이 지정된 자동 생성 프로필 사진에 사용하는 폰트입니다.

이 기능의 config.json 설정은 "InitialFont": "luximbi.ttf"이며 문자열을 입력합니다.

Amazon S3 서명 v2 (Amazon S3 signature v2)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

Mattermost는 기본적으로 Signature V4로 AWS API 호출에 서명하지만, 상황에 따라 V2가 필요할 수 있습니다. V2를 사용해야 하는 경우에 대한 자세한 내용은 https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html 을 참고하세요.

True: Signature Version 2 서명 프로세스를 사용합니다.

False: Signature Version 4 서명 프로세스를 사용합니다.

이 기능의 config.json 설정은 "AmazonS3SignV2": false이며 옵션은 true와 false입니다.

Amazon S3 경로 (Amazon S3 path)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

여러 배포 환경에서 동일한 S3 버킷을 사용할 수 있게 합니다.

이 기능의 config.json 설정은 "AmazonS3PathPrefix: ""이며 문자열을 입력합니다.

GitLab 스코프 (GitLab scope)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

OAuth 클라이언트와 공유할 정보의 범위를 결정하는 OAuth 표준 설정입니다. 현재 GitLab OAuth에서는 지원되지 않습니다.

이 기능의 config.json 설정은 "Scope": ""이며 문자열을 입력합니다.

Global Relay SMTP 서버 제한 시간 (Global relay SMTP server timeout)

Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

SMTP 서버 연결 시도를 포기하기까지 경과할 수 있는 시간(초)입니다. 기본값은 1800초입니다. 이 설정은 현재 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

이 기능의 config.json 설정은 "GlobalRelaySettings.SMTPServerTimeout": "1800"이며 숫자를 입력합니다.

Google 스코프 (Google scope)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

OAuth 클라이언트와 공유할 정보의 범위를 결정하는 OAuth 표준 설정입니다. 권장 설정은 profile email입니다.

이 기능의 config.json 설정은 "Scope": "profile email"이며 문자열을 입력합니다.

가져오기 입력 디렉터리 (Import input directory)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

가져온 파일이 저장되는 디렉터리입니다. 경로는 FileSettings 디렉터리를 기준으로 합니다. 기본적으로 가져오기 파일은 ./data/import 아래에 저장됩니다.

이 기능의 ImportSettings 섹션 아래 config.json 설정은 Directory: ./import이며 문자열을 입력합니다.

가져오기 보존 일수 (Import retention days)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

가져온 파일을 삭제하기 전까지 보관할 일수입니다.

이 기능의 ImportSettings 섹션 아래 config.json 설정은 RetentionDays: 30이며 숫자를 입력합니다.

내보내기 시작 타임스탬프 (Export from timestamp)

Enterprise, Enterprise Advanced 플랜에서 사용할 수 있습니다.

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

데이터를 내보낼 시작 지점의 Unix 타임스탬프(UTC 기준 epoch 이후 초)를 설정합니다.

이 기능의 config.json 설정은 "ExportFromTimestamp": 0이며 숫자를 입력합니다.

Entra ID 스코프 (Entra ID Scope)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

OAuth 클라이언트와 공유할 정보의 범위를 결정하는 OAuth 표준 설정입니다. 권장 설정은 User.Read입니다.

이 기능의 config.json 설정은 "Scope": "User.Read"이며 문자열을 입력합니다.

플러그인 업로드 활성화 (Enable plugin uploads)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

True: 시스템 관리자가 Plugins > Management에서 플러그인을 업로드할 수 있게 합니다. 플러그인을 업로드할 계획이 없다면 서버에 설치되는 플러그인을 통제할 수 있도록 false로 설정하세요. 자세한 내용은 관련 문서를 참고하세요.

False: Mattermost 서버에서 플러그인 업로드를 비활성화합니다.

이 기능의 config.json 설정은 "EnableUploads": false이며 옵션은 true와 false입니다.

안전하지 않은 다운로드 URL 허용 (Allow insecure download URL)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

True: 원격 URL에서 플러그인을 다운로드해 설치할 수 있게 합니다.

False: 원격 URL에서 플러그인을 다운로드해 설치하는 기능을 비활성화합니다.

이 기능의 config.json 설정은 "AllowInsecureDownloadUrl": false이며 옵션은 true와 false입니다.

플러그인 상태 점검 활성화 (Enable plugin health check)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

True: 플러그인 상태 점검을 활성화해 모든 플러그인을 주기적으로 모니터링하고, 상태에 따라 재시작하거나 비활성화합니다. 상태 점검은 30초마다 실행됩니다. 플러그인이 한 시간 안에 3회 실패하면 Mattermost 서버가 재시작을 시도합니다. 재시작이 연속 3회 실패하면 해당 플러그인은 자동으로 비활성화됩니다.

False: Mattermost 서버에서 플러그인 상태 점검을 비활성화합니다.

이 기능의 config.json 설정은 "EnableHealthCheck": true이며 옵션은 true와 false입니다.

플러그인 디렉터리 (Plugin directory)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

플러그인 파일의 위치입니다. 비워 두면 ./plugins 디렉터리에 저장됩니다. 지정한 경로는 실제로 존재해야 하며 Mattermost가 해당 경로에 쓰기 권한을 가지고 있어야 합니다.

이 기능의 config.json 설정은 "Directory": "./plugins"이며 문자열을 입력합니다.

클라이언트 플러그인 디렉터리 (Client plugin directory)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

클라이언트 플러그인 파일의 위치입니다. 비워 두면 ./client/plugins 디렉터리에 저장됩니다. 지정한 경로는 실제로 존재해야 하며 Mattermost가 해당 경로에 쓰기 권한을 가지고 있어야 합니다.

이 기능의 config.json 설정은 "ClientDirectory": "./client/plugins"이며 문자열을 입력합니다.

스코핑 IDP 제공자 ID (Scoping IDP provider ID)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

인증된 사용자가 페더레이션된 Azure AD 서버의 초기 로그인 페이지를 건너뛰고 비밀번호만으로 로그인할 수 있게 합니다.

이 기능의 config.json 설정은 "ScopingIDPProviderId": ""이며 문자열을 입력합니다.

스코핑 IDP 제공자 이름 (Scoping IDP provider name)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

사용자의 스코핑 ID 제공자 ID에 연결된 이름을 추가합니다.

이 기능의 config.json 설정은 "ScopingIDPName": ""이며 문자열을 입력합니다.

읽지 않은 채널 묶기 (Group unread channels)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

이 설정은 새 사이드바에만 적용됩니다. 시스템 콘솔에서 이 기능을 확인하고 활성화하려면 레거시 사이드바 활성화 구성 설정을 비활성화해야 합니다.

Default Off: 모든 사용자에 대해 읽지 않은 채널 사이드바 섹션을 기본적으로 비활성화합니다. 사용자는 Settings > Sidebar > Group unread channels separately에서 활성화할 수 있습니다.

Default On: 모든 사용자에 대해 읽지 않은 채널 사이드바 섹션을 기본적으로 활성화합니다. 사용자는 Settings > Sidebar > Group unread channels separately에서 비활성화할 수 있습니다.

이 기능의 config.json 설정은 "ExperimentalGroupUnreadChannels": "default_off"이며 옵션은 "default_off"와 "default_on"입니다.

채널 카테고리 정렬 활성화 (Enable channel category sorting)

Mattermost v10.10부터, 이 실험적 기능을 활성화하면 사용자가 채널을 만들거나 이름을 변경할 때 새 채널 카테고리나 기존 채널 카테고리에 채널을 지정할 수 있습니다.

이 구성 설정은 클라우드 기반 배포에만 적용됩니다.

True: 사용자가 채널을 만들거나 이름을 변경할 때 새 채널 카테고리나 기존 채널 카테고리에 채널을 지정할 수 있습니다.

False: (기본값) 새 채널 카테고리나 기존 채널 카테고리에 채널을 자동으로 지정하는 기능을 비활성화합니다.

이 기능의 config.json 설정은 "ExperimentalEnableChannelCategorySorting": false이며 옵션은 true와 false입니다.

참고

Mattermost v11.8부터 채널 카테고리 정렬은 정식 기능으로 제공되며 기본적으로 활성화됩니다. System Console > Site Configuration > Users and Teams에서 채널 카테고리 정렬 설정(TeamSettings.EnableChannelCategorySorting)으로 구성하세요.

엄격한 CSRF 토큰 적용 (Strict CSRF token enforcement)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

True: 현재 사용 중인 커스텀 헤더 방식보다 보안을 강화하기 위해 CSRF 보호 토큰을 활성화합니다. 사용자가 로그인하면 CSRF 토큰이 담긴 쿠키가 추가로 생성됩니다.

False: CSRF 보호 토큰을 비활성화하고 하위 호환을 위해 레거시 X-Requested-With 헤더 폴백을 활성화합니다.

이 기능의 config.json 설정은 "ExperimentalStrictCSRFEnforcement": false이며 옵션은 true와 false입니다.

개발자 플래그 (Developer flags)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

이 구성 설정은 Mattermost 웹 앱의 콘텐츠 보안 정책(CSP)을 설정하는 데 사용하는 플래그 문자열의 목록을 지정합니다. 각 플래그는 flag=true 형식이어야 합니다(예: unsafe-eval=true,unsafe-inline=true). 운영 환경에서는 권장하지 않습니다.

현재 지원되는 값은 다음과 같습니다.

  • unsafe-eval: 루트 웹 앱에 unsafe-eval CSP 지시문을 추가해 개발 환경에서 디버깅을 더 수월하게 합니다.
  • unsafe-inline: 루트 웹 앱에 unsafe-inline CSP 지시문을 추가해 개발 환경에서 디버깅을 더 수월하게 합니다.

이 구성 설정은 기본적으로 비활성화되어 있으며 개발자 모드가 활성화되어 있어야 합니다.

이 기능의 config.json 설정은 "DeveloperFlags": ""이며 문자열을 입력합니다.

게시물 검색 활성화 (Enable post search)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

이 설정을 활성화하면 사용자가 Mattermost 인스턴스에서 메시지를 검색할 수 있습니다.

이 기능의 config.json 설정은 "EnablePostSearch": true이며 옵션은 true와 false입니다.

참고

대규모 배포에서 이 실험적 구성 설정을 비활성화하면 다음 영역에서 서버 성능이 향상될 수 있습니다.

  • 데이터베이스 부하 감소: 게시물 검색이 활성화되어 있으면 모든 검색 쿼리가 데이터베이스에 부하를 더합니다. 검색을 비활성화하면 이러한 쿼리가 줄어 데이터베이스 성능이 좋아지고 다른 작업의 응답 시간도 짧아집니다.
  • 메모리 사용량 감소: 검색 기능은 대개 게시물 인덱싱을 필요로 하며 이는 메모리를 소비합니다. 검색을 비활성화하면 인덱스 유지에 쓰이던 메모리가 다른 용도로 해제되어 전체 시스템 성능이 향상됩니다.
  • 쓰기 작업 속도 향상: 게시물 검색이 활성화되어 있으면 게시물이 새로 작성·편집·삭제될 때마다 인덱스를 갱신해야 합니다. 검색을 비활성화하면 이 부담이 사라져 쓰기 작업이 빨라집니다.
  • 일관된 성능: 검색 기능이 없으면 잠재적인 성능 병목을 피할 수 있어, 특히 게시물이 많은 고부하 상황에서도 더 일관된 성능을 유지할 수 있습니다.
  • 시스템 유지 보수 단순화: 검색 인덱스 관리는 복잡하고 자원을 많이 소모할 수 있습니다. 검색을 비활성화하면 이 부분의 시스템 유지 보수가 단순해지고, 검색 인덱스 손상이나 성능 저하로 인한 문제 위험도 줄어듭니다.
  • 다만 Mattermost에서 메시지를 검색하는 기능은 많은 사용자에게 핵심 기능이며, 이 기능을 비활성화하면 사용자가 Mattermost 검색창을 사용하려 할 때 오류를 보게 됩니다. 성능 향상과 조직 및 사용자의 필요 사이에서 균형을 잡는 것이 중요합니다.

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

중요

이 실험적 구성 설정을 사용하면 사용자가 메시지에 첨부된 문서를 파일 이름으로 검색할 수 있습니다. 문서 내용으로 검색할 수 있게 하려면 ExtractContent 구성 설정도 함께 활성화해야 합니다. 자세한 내용은 내용 기반 문서 검색 활성화 문서를 참고하세요. 문서 내용 검색은 Mattermost 서버 v5.35부터 사용할 수 있으며 모바일 지원은 곧 제공될 예정입니다.

True: 지원되는 문서 유형을 파일 이름으로 검색할 수 있습니다.

False: 파일 기반 검색이 비활성화됩니다.

이 기능의 config.json 설정은 "EnableFileSearch": true이며 옵션은 true와 false입니다.

참고

대규모 배포에서 이 실험적 구성 설정을 비활성화하면 다음 영역에서 서버 성능이 향상될 수 있습니다.

  • 인덱싱할 데이터 감소: 메시지에 더해 파일까지 인덱싱하면 검색 인덱스에서 처리하고 저장해야 하는 데이터양이 늘어납니다.
  • 복잡한 쿼리 감소: 파일 검색에는 더 복잡한 쿼리가 필요할 수 있으며, 이는 메시지만 검색할 때보다 자원을 많이 쓰고 시간도 오래 걸립니다.
  • IO 작업 감소: 파일 검색은 더 많은 입출력 작업을 발생시켜 전체 디스크 성능에 영향을 줄 수 있으며, 특히 파일 업로드와 검색이 많은 시스템에서 그렇습니다.
  • 다만 Mattermost에서 파일을 검색하는 기능은 많은 사용자에게 핵심 기능이며, 이 기능을 비활성화하면 사용자가 Mattermost 검색창을 사용하려 할 때 오류를 보게 됩니다. 성능 향상과 조직 및 사용자의 필요 사이에서 균형을 잡는 것이 중요합니다.

사용자 상태 업데이트 활성화 (Enable user status updates)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

성능을 개선하려면 상태 업데이트를 끄세요. 상태 업데이트를 끄면 사용자는 메시지를 게시하는 짧은 순간에만, 그리고 그 메시지가 게시된 채널의 구성원에게만 온라인으로 표시됩니다.

이 기능의 config.json 설정은 "EnableUserStatuses": true이며 옵션은 true와 false입니다.

웹소켓 보안 포트 (Websocket secure port)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다. 이 설정을 변경하면 적용을 위해 서버를 재시작해야 합니다.

(선택 사항) 이 설정은 wss 프로토콜을 사용하는 보안 WebSocket이 수신할 포트를 정의합니다. 기본값은 443입니다. 클라이언트는 WebSocket 연결을 시도할 때 먼저 페이지가 HTTPS로 로드되었는지 확인합니다. HTTPS라면 보안 WebSocket 연결을, 아니라면 비보안 WebSocket 연결을 사용합니다. 운영 배포 환경에서는 반드시 HTTPS와 WSS로만 운영할 것을 강력히 권장합니다.

이 기능의 config.json 설정은 "WebsocketSecurePort": 443이며 숫자를 입력합니다.

참고

이 값은 클라이언트에만 적용되는 재정의이며, 웹 서버 수신 주소 설정으로 제어되는 서버 프로세스의 수신 포트에는 영향을 주지 않습니다.

웹소켓 포트 (Websocket port)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다. 이 설정을 변경하면 적용을 위해 서버를 재시작해야 합니다.

(선택 사항) 이 설정은 ws 프로토콜을 사용하는 비보안 WebSocket이 수신할 포트를 정의합니다. 기본값은 80입니다. 클라이언트는 WebSocket 연결을 시도할 때 먼저 페이지가 HTTPS로 로드되었는지 확인합니다. HTTPS라면 보안 WebSocket 연결을, 아니라면 비보안 WebSocket 연결을 사용합니다. 운영 배포 환경에서는 반드시 HTTPS와 WSS로만 운영할 것을 강력히 권장합니다.

이 기능의 config.json 설정은 WebsocketPort": 80이며 숫자를 입력합니다.

참고

이 값은 클라이언트에만 적용되는 재정의이며, 웹 서버 수신 주소 설정으로 제어되는 서버 프로세스의 수신 포트에는 영향을 주지 않습니다.

mmctl 로컬 모드 활성화 (Enable local mode for mmctl)

이 자체 호스팅 배포 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

True: mmctl의 로컬 모드를 활성화합니다.

False: mmctl의 로컬 모드를 차단합니다.

이 기능의 config.json 설정은 "EnableLocalMode": false이며 옵션은 true와 false입니다.

팁

mmctl에서 로컬 모드를 사용할 때는 서버와 mmctl을 같은 사용자로 실행하거나, 다른 사용자로 전환하기 전에 소켓 파일을 정리하세요. socket file "/var/tmp/mattermost_local.socket" doesn't exists, please check the server configuration for local mode와 같은 오류가 발생하면 이 구성 설정을 true로 설정해 해결할 수 있습니다.

로컬 모드 소켓 위치 (Enable local mode socket location)

이 자체 호스팅 배포 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

mmctl이 로컬 모드로 연결해 통신할 수 있도록 서버가 생성할 소켓의 경로입니다. 이 키의 기본값을 변경하면 로컬 모드에서 --local 플래그와 함께 --local-socket-path /new/path/to/socket 플래그를 사용해 mmctl에 새 소켓 경로를 지정해야 합니다.

아무것도 지정하지 않으면 서버와 mmctl 모두 기본 경로로 /var/tmp/mattermost_local.socket을 사용합니다.

이 기능의 config.json 설정은 "LocalModeSocketLocation": "/var/tmp/mattermost_local.socket"이며 문자열을 입력합니다.

기본 채널 (Default channels)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

새 팀에 참여한 뒤 모든 사용자가 자동으로 추가되는 기본 채널입니다. 공개 채널에만 적용되지만 서버의 모든 팀에 영향을 줍니다.

설정하지 않으면 모든 사용자가 기본적으로 town-square 채널에 추가됩니다.

참고

town-square가 목록에 없더라도 모든 사용자는 새 팀에 참여할 때 해당 채널에 자동으로 추가됩니다.

이 기능의 config.json 설정은 "ExperimentalDefaultChannels": []이며 ["announcement", "developers"]와 같이 채널 이름으로 구성된 문자열 배열을 입력합니다.

실험적 작업 구성 설정

자체 호스팅 배포에서는 데이터 보존이 활성화된 경우의 오래된 게시물 삭제나 Elasticsearch를 통한 게시물 인덱싱처럼 주기적으로 수행되는 작업을 Mattermost가 어떻게 예약하고 완료할지 구성할 수 있습니다. 이 설정들은 어떤 Mattermost 서버를 작업을 적절한 시각에 큐에 넣는 Scheduler로, 어떤 서버를 주어진 작업을 완료하는 Worker로 지정할지 제어합니다.

Mattermost를 단일 머신에서 실행할 때는 RunJobs와 RunScheduler를 모두 활성화해야 합니다. 둘 다 활성화하지 않으면 Mattermost가 정상적으로 동작하지 않습니다.

Mattermost를 고가용성 모드로 실행할 때는 일반적으로 RunJobs를 하나 이상의 서버에서 활성화하고 RunScheduler는 모든 서버에서 활성화해야 합니다. 고가용성 클러스터 기반 배포에는 하나의 Scheduler와 하나 이상의 Worker가 있습니다. 자세한 내용은 아래 섹션을 참고하세요.

작업 실행 (Run jobs)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

이 Mattermost 서버가 Scheduler가 생성한 작업을 처리할지 여부를 설정합니다. Mattermost를 단일 머신에서 실행할 때는 이 설정을 항상 활성화해야 합니다.

Mattermost를 고가용성 모드로 실행할 때는 하나 이상의 서버에서 이 설정을 활성화해야 합니다. 고가용성 클러스터 기반 배포에서는 이 설정을 활성화한 전용 Worker를 하나 이상 두고, 나머지 Mattermost 앱 서버에서는 비활성화하는 것을 권장합니다.

이 기능의 config.json 설정은 "RunJobs": true이며 옵션은 true와 false입니다.

스케줄러 실행 (Run scheduler)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

이 Mattermost 서버가 Worker가 완료할 작업을 예약할지 여부를 설정합니다. Mattermost를 단일 머신에서 실행할 때는 이 설정을 항상 활성화해야 합니다.

Mattermost를 고가용성 모드로 실행할 때는 이 설정을 항상 활성화해야 합니다. 고가용성 클러스터 기반 배포에서는 중복 작업이 생기지 않도록 한 번에 정확히 한 대의 서버만 Scheduler로 지정됩니다. 자세한 내용은 고가용성 문서를 참고하세요.

주의

이 설정은 기본값 true에서 변경하지 않는 것을 강력히 권장합니다. 변경하면 ClusterLeader가 스케줄러를 실행할 수 없게 되고, 그 결과 LDAP 동기화, 컴플라이언스 내보내기, 데이터 보존 같은 반복 작업이 더 이상 예약되지 않습니다. 이전 Mattermost 서버 버전과 이 문서에서는 Job Server를 RunScheduler: false로 실행하라고 안내했지만, 클러스터 설계가 발전하면서 더 이상 그렇지 않습니다.

팁

Mattermost v11.4부터는 클러스터에서 특정 반복 작업(예약 게시물, 게시물 알림, DND 상태 재설정)이 올바르게 실행되는지 확인할 수 있도록 디버그 수준 로그 메시지가 제공됩니다. 리더가 아닌 노드는 이러한 반복 작업의 실행을 건너뛸 때 로그를 남겨 리더 선출이 정상적으로 동작하고 있음을 확인해 줍니다. 이 디버그 메시지는 Elasticsearch 인덱싱, SAML 동기화, LDAP 동기화 같은 다른 작업 유형에는 적용되지 않습니다. 자세한 내용은 클러스터 작업 실행 디버그 메시지를 참고하세요.

이 기능의 config.json 설정은 "RunScheduler": true이며 옵션은 true와 false입니다.

오래된 데이터베이스 작업 정리 (Clean up old database jobs)

이 설정은 시스템 콘솔에서 제공되지 않으며 config.json에서만 설정할 수 있습니다.

완료된 데이터베이스 작업 중 이 일수를 넘긴 항목을 제거하는 기준을 정의합니다. 이 설정은 기본적으로 비활성화되어 있으며 0 이상의 값으로 설정해야 활성화됩니다.

이 기능의 config.json 설정은 "JobSettings.CleanupJobsThresholdDays": -1이며 숫자를 입력합니다.

오래된 데이터베이스 항목 정리 (Clean up outdated database entries)

이 설정은 데이터베이스에 저장된 구성에만 적용됩니다. 시스템 콘솔에서는 제공되지 않으며 mmctl을 통하거나 데이터베이스에서 직접 변경할 수 있습니다.

오래된 구성을 데이터베이스에서 제거하는 기준 일수를 정의합니다.

이 기능의 config.json 설정은 "JobSettings.CleanupConfigThresholdDays": 30이며 숫자를 입력합니다.