InfoGrab Docs

실험적 구성 설정

요약

제품 메뉴 → System Console → Experimental > Features에서 다음 실험적 구성 옵션을 검토하고 관리하세요: 셀프 호스팅 Mattermost를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다.

제품 메뉴 → System Console → Experimental > Features에서 다음 실험적 구성 옵션을 검토하고 관리하세요:

Tip

셀프 호스팅 Mattermost를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 각 구성 값에는 JSON 인식 도구를 사용하여 프로그래밍 방식으로 config.json 파일에서 값에 접근할 수 있는 JSON 경로가 포함됩니다. 예를 들어, LoginButtonColor 값은 LdapSettings 아래에 있습니다.

    • jq <https://stedolan.github.io/jq/>`__ 와 같은 도구를 사용하는 경우: cat config/config.json | jq '.LdapSettings.LoginButtonColor'</li><li>config.json 파일을 수동으로 편집할 때는 LdapSettings 와 같은 객체를 찾은 뒤 그 안에서 LoginButtonColor`` 키를 찾으세요.

#

실험적 System Console 구성 설정#

AD/LDAP 로그인 버튼 색상#

화이트 라벨링을 위한 AD/LDAP 로그인 버튼의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonColor": "" with string input.

AD/LDAP 로그인 버튼 테두리 색상#

화이트 라벨링을 위한 AD/LDAP 로그인 버튼 테두리의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonBorderColor": "" with string input.

AD/LDAP 로그인 버튼 텍스트 색상#

화이트 라벨링을 위한 AD/LDAP 로그인 버튼 텍스트의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonTextColor": "" with string input.
  • true: (Default) Users can change their sign-in method to any that is enabled on the server, either via their Profile or the APIs.
  • false: Users cannot change their sign-in method, regardless of which authentication options are enabled.

인증 방법 변경#

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

False: 활성화된 인증 옵션에 관계없이 사용자가 로그인 방법을 변경할 수 없습니다.

This feature's config.json setting is "ExperimentalEnableAuthenticationTransfer": true with options true and false.

링크 메타데이터 타임아웃#

링크 메타데이터를 반환하는 요청에 대한 구성 가능한 타임아웃을 추가합니다. 타임아웃이 만료되기 전에 메타데이터가 반환되지 않으면 메타데이터 없이 메시지가 게시됩니다. 이 타임아웃은 끊어진 URL과 느린 네트워크 연결에서의 잘못된 콘텐츠 유형 실패 케이스를 처리합니다.

This feature's config.json setting is "LinkMetadataTimeoutMilliseconds: 5000`` with numerical input.

이메일 일괄 처리 버퍼 크기#

단일 이메일에 일괄 처리되는 알림의 최대 수를 지정합니다.

Note
    • Mattermost 로그에 다음 오류가 표시되면 기본값에서 버퍼 크기를 늘리는 것을 권장합니다: Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail. 이 값을 늘리면 서버 성능에 영향을 주지 않고 이메일이 대기열에 쌓입니다.
    • 이메일 대기열이 구성된 이메일 일괄 처리 간격 을 초과하면 알림이 즉시 전송됩니다.
This feature's config.json setting is EmailBatchingBufferSize: 256`` with numerical input.

이메일 일괄 처리 간격#

일괄 처리 작업이 새 알림을 확인하는 최대 빈도(초)를 지정합니다.

Note
    • Mattermost 로그에 다음 오류가 표시되면 기본값에서 이메일 일괄 처리 간격을 줄이는 것을 권장합니다: Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail.
    • 일괄 처리 간격이 길수록 성능이 향상될 수 있습니다.
    • 이메일 대기열 이 구성된 이메일 일괄 처리 간격을 초과하면 알림이 즉시 전송됩니다.
This feature's config.json setting is EmailBatchingInterval": 30 with numerical input.

이메일 로그인 버튼 색상#

화이트 라벨링을 위한 이메일 로그인 버튼의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonColor": "" with string input.

이메일 로그인 버튼 테두리 색상#

화이트 라벨링을 위한 이메일 로그인 버튼 테두리의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonBorderColor": "" with string input.

이메일 로그인 버튼 텍스트 색상#

화이트 라벨링을 위한 이메일 로그인 버튼 텍스트의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonTextColor": "" with string input.
  • true: Ability for users to deactivate their own account from Settings > Advanced is enabled.
  • false: (Default) Ability for users to deactivate their own account is disabled.

계정 비활성화 활성화#

True: 사용자가 설정 > 고급 > 계정 비활성화에서 자신의 계정을 비활성화할 수 있습니다. 계정을 비활성화하면 확인 이메일이 발송됩니다. 이메일/비밀번호 인증 방식에서만 사용 가능하며, SAML 또는 AD/LDAP 인증 방식에서는 사용할 수 없습니다.

False: 사용자의 계정 자체 비활성화 기능이 비활성화됩니다.

This feature's config.json setting is "EnableUserDeactivation": false with options true and false.
  • true: Users can enable Automatic Replies in Settings > Notifications.
  • false: (Default) Disables the Automatic Direct Message Replies feature and hides it from Settings.

자동 답장 활성화#

True: 사용자가 설정 > 알림에서 자동 답장을 활성화할 수 있습니다. 다이렉트 메시지에 자동으로 발송될 사용자 정의 메시지를 설정합니다.

False: 자동 다이렉트 메시지 답장 기능을 비활성화하고 설정에서 숨깁니다.

This feature's config.json setting is "ExperimentalEnableAutomaticReplies": false with options true and false.

채널 열람 WebSocket 메시지 활성화#

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

This feature's config.json setting is "EnableChannelViewedMessages": true with options true and false.
Note

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

    • 데이터베이스 부하 감소: channel_viewed 이벤트가 비활성화되면 서버가 더 이상 이 이벤트를 데이터베이스에 기록할 필요가 없습니다. 이는 쓰기 및 업데이트 작업 수를 줄여줍니다.
    • 네트워크 트래픽 감소: 이 이벤트를 비활성화하면 서버와 클라이언트 간에 전송되는 메시지가 줄어듭니다.
    • 서버 CPU 사용량 감소: channel_viewed 이벤트 처리에는 데이터베이스 트랜잭션 및 네트워크 통신을 처리하는 CPU 리소스가 필요합니다.
    • 사용자 경험 향상: 서버 부하 및 네트워크 트래픽 감소로 로딩 시간이 빨라질 수 있습니다.
    • 단, 이 설정을 비활성화하면 채널의 읽음/읽지 않음 메시지 추적 등 일부 기능에 영향을 줍니다.
    • true: (Default) Enables leave/join system messages in the default town-square channel.
    • false: Disables leave/join messages from the default town-square channel.

기본 채널 나가기/참여 시스템 메시지 활성화#

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

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

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

This feature's config.json setting is "ExperimentalEnableDefaultChannelLeaveJoinMessages": true with options true and false.
  • true: Enables a hardened mode for Mattermost that makes user experience trade-offs in the interest of security.
  • false: (Default) Disables hardened mode.

강화 모드 활성화#

True: 보안을 위한 사용자 경험 트레이드오프가 적용된 Mattermost 강화 모드를 활성화합니다.

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

강화 모드 활성화 시 적용되는 변경 사항:

  • 로그인 실패 시 사용자명/비밀번호에 대한 구체적인 오류 메시지 대신 일반적인 오류 메시지가 반환됩니다.
  • 다중 인증(MFA) 가 활성화된 경우, 사용자의 MFA 활성화 여부 확인 경로가 항상 true를 반환합니다.
  • 비밀번호 재설정 시 SSO 계정을 Mattermost를 통해 재설정할 수 없다는 안내 없이 재설정 이메일이 발송되었다고 표시됩니다.
  • Mattermost는 클라이언트에 반환되기 전에 모든 500 오류를 정제합니다. 제공된 request_id 를 사용하여 사용자 오류와 서버 로그를 대조하세요.
  • 사용자명과 비밀번호로 인증된 일반 사용자는 override_username 또는 override_icon_url 같은 통합용 예약 게시물 속성을 사용할 수 없습니다.
This feature's config.json setting is "ExperimentalEnableHardenedMode": false with options true and false.
  • true: (Default) Enables the Display > Theme tab in Settings so users can select their theme.
  • false: Users cannot select a different theme. The Display > Theme tab is hidden in Settings.

테마 선택 활성화#

True: 설정의 표시 > 테마 탭을 활성화하여 사용자가 테마를 선택할 수 있게 합니다.

False: 사용자가 다른 테마를 선택할 수 없습니다. 설정의 표시 > 테마 탭이 숨겨집니다.

This feature's config.json setting is "EnableThemeSelection": true with options true and false.
  • true: (Default) Enables the Display > Theme > Custom Theme section in Settings.
  • false: Users cannot use a custom theme. The Display > Theme > Custom Theme section is hidden in Settings.

사용자 정의 테마 허용#

True: 설정의 표시 > 테마 > 사용자 정의 테마 섹션을 활성화합니다.

False: 사용자가 사용자 정의 테마를 사용할 수 없습니다. 설정의 표시 > 테마 > 사용자 정의 테마 섹션이 숨겨집니다.

This feature's config.json setting is "AllowCustomThemes": true with options true and false.

기본 테마#

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

This feature's config.json setting is "DefaultTheme": "default" with options "default", "organization", "mattermostDark", and "windows10".
  • true: (Default) Users are prompted with a tutorial when they open Mattermost for the first time after account creation.
  • false: The tutorial is disabled. Users are placed in Town Square when they open Mattermost for the first time after account creation.

튜토리얼 활성화#

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

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

This feature's config.json setting is "ServiceSettings.EnableTutorial": true with options true and false.
  • true: (Default) New Mattermost users are shown key tasks to complete as part of initial onboarding.
  • false: User onboarding tasks are disabled. Users are placed in Town Square when they open Mattermost for the first time after account creation.

온보딩 흐름 활성화#

True: 새 Mattermost 사용자에게 초기 온보딩의 일환으로 완료해야 할 주요 작업이 표시됩니다.

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

This feature's config.json setting is "ServiceSettings.EnableOnboardingFlow": true with options true and false.

사용자 입력 중 메시지 활성화#

이 설정은 웹 브라우저 또는 데스크톱 앱에서 Mattermost 사용 시 메시지 입력창 아래에 "입력 중..." 메시지를 표시할지 여부를 결정합니다.

This feature's config.json setting is "EnableUserTypingMessages": true with options true and false.
Note

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

    • 서버 부하 감소: 입력 이벤트는 추가적인 WebSocket 트래픽을 발생시킵니다. 비활성화하면 서버가 처리해야 하는 데이터 양이 줄어듭니다.
    • 네트워크 트래픽 감소: 입력 이벤트가 활성화되면 키 입력마다 네트워크 이벤트가 발생합니다. 이를 비활성화하면 네트워크를 통해 전송되는 정보의 양이 줄어듭니다.
    • 클라이언트 성능 향상: 클라이언트 측에서 입력 이벤트 처리에 리소스가 필요합니다. 이 이벤트를 처리하지 않으면 클라이언트가 더 빠르게 응답하고 메모리와 CPU 사용량이 줄어듭니다.

사용자 입력 타임아웃#

이 설정은 "입력 중..." 메시지가 업데이트되는 빈도(밀리초)를 정의합니다.

This feature's config.json setting is "TimeBetweenUserTypingUpdatesMilliseconds": 5000 with numerical input.

사용자 상태 및 프로필 조회 폴링 간격#

사용자 상태 및 프로필을 주기적으로 조회하는 사이의 대기 시간(밀리초)을 구성합니다. 0 으로 설정하면 비활성화됩니다.

This feature's config.json setting is "ExperimentalSettings.UsersStatusAndProfileFetchingPollIntervalMilliseconds": 3000 with numerical input.
Note

이 구성 설정 값을 줄이면 Mattermost가 업데이트된 사용자 프로필 정보를 더 자주 확인하고 가져옵니다. 값을 줄이면 오래되거나 누락된 데이터로 인해 채널에서 사용자명이 Someone으로 표시되는 경우를 줄이는 데 도움이 됩니다.

기본 팀#

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

기본 팀의 URL이 https://example.mattermost.com/myteam/ 인 경우, config.json 에서 값을 myteam 으로 설정하세요.

This feature's config.json setting is "ExperimentalPrimaryTeam": "" with string input.

SAML 로그인 버튼 색상#

화이트 라벨링을 위한 SAML 로그인 버튼의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonColor": "" with string input.

SAML 로그인 버튼 테두리 색상#

화이트 라벨링을 위한 SAML 로그인 버튼 테두리의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonBorderColor": "" with string input.

SAML 로그인 버튼 텍스트 색상#

화이트 라벨링을 위한 SAML 로그인 버튼 텍스트의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonTextColor": "" with string input.
  • true: Channel and team name appears in email notification subject lines.
  • false: (Default) Only team name appears in email notification subject line.

이메일 알림에 채널 이름 사용#

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

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

This feature's config.json setting is "UseChannelInEmailNotifications": false with options true and false.

사용자 자리 비움 상태 타임아웃#

이 설정은 사용자가 Mattermost를 사용하지 않을 때 상태 표시가 "자리 비움"으로 변경되기까지의 시간(초)을 정의합니다.

This feature's config.json setting is "UserStatusAwayTimeout": 300 with numerical input.

브라우저 포커스 복귀 시 데이터 재조회 비활성화#

이 설정은 브라우저 포커스 복귀 시 채널 및 채널 멤버를 다시 조회하는 기능을 비활성화합니다.

True: 브라우저가 포커스를 다시 받을 때 Mattermost가 채널 및 채널 멤버를 재조회하지 않습니다. 채널 및 멤버가 많은 사용자의 성능이 향상될 수 있습니다.

False: (기본값) 브라우저가 포커스를 다시 받을 때 Mattermost가 채널 및 채널 멤버를 재조회합니다.

This feature's config.json setting is "ExperimentalSettings.DisableRefetchingOnBrowserFocus": false with options true and false.

절전 모드 해제 재연결 핸들러 비활성화#

이 설정은 컴퓨터 절전 모드 해제 감지 및 데이터 재조회 시도를 비활성화합니다.

True: Mattermost가 컴퓨터 절전 모드 해제를 감지하거나 데이터를 재조회하려 하지 않습니다. 앱이 전송하는 일반적인 네트워크 트래픽을 줄일 수 있습니다.

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

This feature's config.json setting is "ExperimentalSettings.DisableWakeUpReconnectHandler": false with options true and false.

채널 자동 완성 지연#

이 설정은 메시지 작성 중 물결표(~) 입력 시 채널 링크 자동 완성이 즉시 실행될지 여부를 제어합니다. 이 설정은 문장 부호로 물결표를 사용하는 사람들에게 ~town-square 와 같은 채널 자동 완성을 덜 방해적으로 만듭니다.

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

False: (기본값) 사용자가 물결표를 입력하면 즉시 자동 완성이 나타납니다.

This feature's config.json setting is "ExperimentalSettings.DelayChannelAutocomplete": false with options true and false.

YouTube 참조 정책#

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

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

False: (기본값) 참조 정책이 no-referrer 로 설정되어 소스 URL을 공개하지 않아 사용자 개인 정보를 보호하지만, 분석 도구에서 사용자 참여 및 트래픽 소스 추적 기능이 제한됩니다.

This feature's config.json setting is "ExperimentalSettings.YoutubeReferrerPolicy": false with options true and false.

실험적 Bleve 구성 설정#

Important

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

다음 구성 설정은 System Console에서 Experimental > Bleve로 이동하거나 아래 표에 설명된 대로 config.json 파일을 편집하여 접근할 수 있습니다:

  • true: The indexing of new posts occurs automatically.
  • false: (Default) The indexing of new posts does not occur automatically.

Bleve 인덱싱 활성화#

True: 새 게시물이 자동으로 인덱싱됩니다. 검색 쿼리에 Bleve 활성화 가 활성화될 때까지 검색 쿼리에 Bleve 검색이 사용되지 않습니다.

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

This feature's config.json setting is "EnableIndexing": false with options true and false.

인덱스 디렉터리#

Bleve 인덱스를 저장하는 데 사용할 디렉터리 경로입니다.

Tip

Bleve 인덱스 디렉터리 경로는 반드시 mattermost 디렉터리 내에 있을 필요는 없습니다. mattermost 디렉터리 외부에 있는 경우, Mattermost 업그레이드 시 이 파일들을 보존하거나 재인덱싱하기 위한 추가 단계가 필요하지 않습니다. 자세한 내용은 Mattermost 서버 업그레이드 문서를 참조하세요.

This feature's config.json setting is "IndexDir": "" with string input.

즉시 대량 인덱싱#

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

인덱스 삭제#

인덱스 삭제를 선택하여 Bleve 인덱스 디렉터리의 내용을 제거합니다. 기존 데이터베이스의 대량 인덱스가 재구성될 때까지 검색 결과가 불완전할 수 있습니다.

  • true: Search queries will use bleve search.
  • false: (Default) Search queries will not use bleve search.

검색 쿼리에 Bleve 활성화#

True: 검색 쿼리에 Bleve 검색이 사용됩니다.

False: 검색 쿼리에 Bleve 검색이 사용되지 않습니다.

This feature's config.json setting is "EnableSearching": false with options true and false.
  • true: Autocomplete queries will use bleve search.
  • false: (Default) Autocomplete queries will not use bleve search.

자동 완성 쿼리에 Bleve 활성화#

True: 자동 완성 쿼리에 Bleve 검색이 사용됩니다.

False: 자동 완성 쿼리에 Bleve 검색이 사용되지 않습니다.

This feature's config.json setting is "EnableAutocomplete": false with options true and false.

실험적 감사 로그 구성 설정#

Compliance > Audit Logging으로 이동하거나 config.json 파일에서 다음 설정을 활성화하여 감사 이벤트를 출력합니다.

Note

감사 로그 활성화 및 구성 기능은 현재 베타 상태입니다.

고급 로깅#

Mattermost Cloud 배포에서 콘솔, 로컬 파일, syslog, TCP 소켓 대상의 조합에 로그 및 감사 레코드를 출력합니다. 로깅 옵션에 대한 자세한 내용은 고급 로깅 문서를 참조하세요.

감사 로그 활성화#

셀프 호스팅 인스턴스에서 감사 로그가 활성화되면, 아래에 정의된 대로 파일 순환 관리를 위한 크기, 백업 간격, 압축, 최대 보존 기간 및 타임스탬프를 지정할 수 있습니다. 감사 이벤트와 AD/LDAP 이벤트에 대해 독립적으로 설정할 수 있습니다.

True: 감사 로그 파일이 활성화되고, 셀프 호스팅 배포에서 감사 파일이 로컬 파일로 기록됩니다.

False: 감사 로그 파일이 활성화되지 않고, 셀프 호스팅 배포에서 감사 로그가 로컬 파일로 기록되지 않습니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileEnabled": false", with options true and false.

파일 이름#

셀프 호스팅 배포의 감사 파일 경로를 지정합니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileName": "" with string input consisting of a user-defined path (e.g. /var/log/mattermost_audit.log).

최대 파일 크기#

셀프 호스팅 배포에서 파일 순환이 발생하기 전까지 파일이 커질 수 있는 최대 크기(메가바이트)입니다. 기본값은 100 입니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileMaxSizeMB": 100 with numerical input.

최대 파일 보존 기간#

셀프 호스팅 배포에서 파일 순환이 발생하기 전까지 파일이 도달할 수 있는 최대 보존 기간(일)입니다. 기본값은 0 으로 제한 없음을 의미합니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileMaxAgeDays": 0 with numerical input.

최대 파일 백업 수#

셀프 호스팅 배포에서 유지되는 순환 파일의 최대 수입니다. 가장 오래된 파일이 먼저 삭제됩니다. 기본값은 0 으로 백업 수 제한 없음을 의미합니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileMaxBackups": 0 with numerical input.

파일 압축#

true 이면 셀프 호스팅 배포에서 순환된 파일이 gzip 으로 압축됩니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileCompress": false with options true and false.

최대 파일 큐#

이 설정은 셀프 호스팅 배포에서 파일에 쓸 때 언제든지 대기/버퍼링할 수 있는 감사 레코드 수를 결정합니다. 기본값은 1000 레코드입니다.

서버 로그에서 감사 쓰기 실패가 보이지 않는 한 기본값을 유지할 수 있습니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileMaxQueueSize": 1000 with numerical input.

인증서#

Cloud Enterprise 고객은 Syslog 또는 TCP 로깅 대상의 감사 로그 암호화를 위한 인증서를 업로드하고 관리할 수 있습니다. 인증서 업로드 기능은 기능 플래그 ExperimentalAuditSettingsSystemConsoleUI 가 활성화된 경우에만 사용 가능합니다.

System Console > Audit Log Settings > Certificate로 이동하여 파일/인증서 제거를 선택해 System Console에서 인증서 PEM 파일을 업로드합니다. 인증서 파일은 파일 스토어나 파일 시스템 로컬에 저장할 수 있습니다.

셀프 호스팅 전용 실험적 구성 설정#

다음 셀프 호스팅 구성 설정은 아래 표에 설명된 대로 config.json 파일을 편집하여 접근할 수 있습니다. 이 구성 설정들은 System Console을 통해 접근할 수 없습니다.

Tip

아래의 각 구성 값에는 JSON 인식 도구를 사용하여 프로그래밍 방식으로 config.json 파일에서 값에 접근할 수 있는 JSON 경로가 포함됩니다. 예를 들어, SiteURL 값은 ServiceSettings 아래에 있습니다.

    • jq <https://stedolan.github.io/jq/>`__ 와 같은 도구를 사용하는 경우: cat config/config.json | jq '.ServiceSettings.SiteURL'</li><li>config.json 파일을 수동으로 편집할 때는 ServiceSettings 키를 찾은 뒤 그 안에서 SiteURL`` 키를 찾으세요.

허용된 테마#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "AllowedThemes": [] with string array input consisting of the options "default", "organization", "mattermostDark", and "windows10", such as ["mattermostDark", "windows10"].

파일 위치#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "FileLocation": "export" with string input.

푸시 알림 버퍼#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature’s config.json setting is "PushNotificationBuffer": 1000" with numerical input.

시스템 관리자 제한#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: (Cloud 배포의 기본값) 시스템 관리자가 System Console에서 서버 구성 설정의 일부를 보거나 수정하는 것을 제한합니다. 온프레미스 설치에는 권장하지 않습니다. 이는 사용자에게 시스템 관리자 역할을 부여하되 특정 작업을 Cloud 관리자만 수행할 수 있도록 Mattermost Private Cloud를 지원하기 위한 설정입니다.

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

This feature's config.json setting is "RestrictSystemAdmin": "false" with options true and false.
Note

서버 구성 설정의 일부를 보거나 수정하는 것을 시스템 관리자에게 제한하는 기능은 현재 베타 상태입니다.

    • true: Enables client-side certification for your Mattermost server.
    • false: (Default) Client-side certification is disabled.

클라이언트 측 인증서 인증 활성화#

Important

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

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

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

This feature's config.json setting is "ClientSideCertEnable": false with options true and false.
  • primary: After the client side certificate is verified, user's email is retrieved from the certificate and is used to log in without a password.
  • secondary: (Default) After the client side certificate is verified, user's email is retrieved from the certificate and matched against the one supplied by the user. If they match, the user logs in with regular email/password credentials.

클라이언트 측 인증서 로그인 방법#

Important

인증서 기반 인증은 Mattermost v11.0부터 더 이상 사용되지 않습니다. 이 설정은 Mattermost v11.0부터 더 이상 작동하지 않으며 기본값을 유지해야 합니다.

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

Primary: 클라이언트 측 인증서가 확인된 후 인증서에서 사용자의 이메일이 검색되어 비밀번호 없이 로그인하는 데 사용됩니다.

Secondary: (기본값) 클라이언트 측 인증서가 확인된 후 인증서에서 사용자의 이메일이 검색되어 사용자가 제공한 이메일과 비교됩니다. 일치하면 사용자가 일반 이메일/비밀번호 자격 증명으로 로그인합니다.

This feature's config.json setting is "ClientSideCertCheck": "secondary" with options "primary" and "secondary".

내보내기 출력 디렉터리#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting under the ExportSettings section is Directory: ./export with string input.

내보내기 보존 기간(일)#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

내보낸 파일을 삭제하기 전에 보존하는 일 수입니다.

This feature's config.json setting under the ExportSettings section is RetentionDays: 30 with numerical input.

최대 이미지 해상도#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "MaxImageResolution": 33177600 with numerical input.

최대 이미지 디코더 동시성#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

동시에 디코딩할 수 있는 이미지 수를 나타냅니다. 기본값 -1 은 Mattermost가 현재 CPU 수를 자동으로 사용하도록 구성합니다.

Note
    • 이 구성 설정은 서버의 총 메모리 소비에 영향을 줍니다. 단일 이미지의 최대 메모리는 MaxImageResolution <em> 24 바이트 로 결정되며, 기본 최대 이미지 해상도 값은 33MB입니다.
    • 따라서 33MB </em> MaxImageDecoderConcurrency <em> 24 가 서버의 총 메모리보다 작아야 합니다.
    • 예를 들어, 4코어 서버의 경우 이미지 처리를 위해 최소 33 </em> 4 * 24 = 3168MB 의 메모리를 남겨두어야 합니다. 그렇지 않으면 MaxImageResolution 구성 설정을 조정하여 이미지 처리에 필요한 메모리 양을 조절하세요.
This feature's config.json setting is "MaxImageDecoderConcurrency": "-1" with numerical input.

초기 폰트#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

색상 배경의 자동 생성 프로필 사진에 사용되는 폰트입니다.

This feature's config.json setting is "InitialFont": "luximbi.ttf" with string input.
  • true: Use Signature Version 2 Signing Process.
  • false: (Default) Use Signature Version 4 Signing Process.

Amazon S3 서명 v2#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

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

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

This feature's config.json setting is "AmazonS3SignV2": false with options true and false.

Amazon S3 경로#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature’s config.json setting is "AmazonS3PathPrefix: "" with string input.

GitLab 범위#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "Scope": "" with string input.

Global Relay SMTP 서버 타임아웃#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

SMTP 서버에 대한 연결 시도가 중단되기까지 경과할 수 있는 시간(초)입니다. 기본값은 1800초입니다.

This feature's config.json setting is "GlobalRelaySettings.SMTPServerTimeout": "1800" with numerical input.

Google 범위#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "Scope": "profile email" with string input.

가져오기 입력 디렉터리#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting under the ImportSettings section is Directory: ./import with string input.

가져오기 보존 기간(일)#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

가져온 파일을 삭제하기 전에 보존하는 일 수입니다.

This feature's config.json setting under the ImportSettings section is RetentionDays: 30 with numerical input.

타임스탬프부터 내보내기#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

데이터를 내보낼 Unix 타임스탬프(에포크 이후 초, UTC)를 설정합니다.

This feature's config.json setting is "ExportFromTimestamp": 0 with numerical input.

Entra ID 범위#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "Scope": "User.Read" with string input.
  • true: Enables plugin uploads by system admins at Plugins > Management.
  • false: (Default) Disables plugin uploads on your Mattermost server.

플러그인 업로드 활성화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: 시스템 관리자가 플러그인 > 관리에서 플러그인을 업로드할 수 있습니다. 플러그인을 업로드할 계획이 없는 경우 false 로 설정하여 서버에 설치되는 플러그인을 제어하세요. 자세한 내용은 문서 를 참조하세요.

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

This feature's config.json setting is "EnableUploads": false with options true and false.
  • true: Enables downloading and installing a plugin from a remote URL.
  • false: (Default) Disables downloading and installing a plugin from a remote URL.

비보안 다운로드 URL 허용#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: 원격 URL에서 플러그인을 다운로드하고 설치할 수 있습니다.

False: 원격 URL에서 플러그인 다운로드 및 설치가 비활성화됩니다.

This feature's config.json setting is "AllowInsecureDownloadUrl": false with options true and false.
  • true: (Default) Enables plugin health check to ensure all plugins are periodically monitored, and restarted or deactivated based on their health status.
  • false: Disables plugin health check on your Mattermost server.

플러그인 상태 확인 활성화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

False: Mattermost 서버에서 플러그인 상태 확인이 비활성화됩니다.

This feature's config.json setting is "EnableHealthCheck": true with options true and false.

플러그인 디렉터리#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

플러그인 파일의 위치입니다. 비어 있으면 ./plugins 디렉터리에 저장됩니다. 설정한 경로가 존재해야 하며 Mattermost에 쓰기 권한이 있어야 합니다.

This feature's config.json setting is "Directory": "./plugins" with string input.

클라이언트 플러그인 디렉터리#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "ClientDirectory": "./client/plugins" with string input.

범위 지정 IDP 공급자 ID#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "ScopingIDPProviderId": "" with string input.

범위 지정 IDP 공급자 이름#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

사용자의 범위 지정 ID 공급자 ID와 연관된 이름을 추가합니다.

This feature's config.json setting is "ScopingIDPName": "" with string input.
  • default_off: (Default) Disables the unread channels sidebar section for all users by default. Users can enable it in Settings > Sidebar > Group unread channels separately.
  • default_on: Enables the unread channels sidebar section for all users by default. Users can disable it in Settings > Sidebar > Group unread channels separately.

읽지 않은 채널 그룹화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

이 설정은 새 사이드바에만 적용됩니다. System Console에서 이 기능을 보거나 활성화하려면 레거시 사이드바 활성화 구성 설정을 비활성화해야 합니다.

기본값 꺼짐: 기본적으로 모든 사용자의 읽지 않은 채널 사이드바 섹션을 비활성화합니다. 사용자는 설정 > 사이드바 > 읽지 않은 채널 별도로 그룹화에서 활성화할 수 있습니다.

기본값 켜짐: 기본적으로 모든 사용자의 읽지 않은 채널 사이드바 섹션을 활성화합니다. 사용자는 설정 > 사이드바 > 읽지 않은 채널 별도로 그룹화에서 비활성화할 수 있습니다.

This feature's config.json setting is "ExperimentalGroupUnreadChannels": "default_off" with options "default_off" and "default_on".
  • true: Users can assign channels to new or existing channel categories when creating or renaming channels.
  • false: (Default) Disables the ability to assign channels to new or existing channel categories when creating or renaming channels.

채널 카테고리 정렬 활성화#

Mattermost v10.10부터 이 실험적 기능이 활성화되면 사용자가 채널을 만들거나 이름을 바꿀 때 새 채널 카테고리 또는 기존 채널 카테고리에 채널을 할당할 수 있습니다.

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

True: 사용자가 채널을 만들거나 이름을 바꿀 때 새 채널 카테고리 또는 기존 채널 카테고리에 채널을 할당할 수 있습니다.

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

This feature's config.json setting is "ExperimentalEnableChannelCategorySorting": false with options true and false.
  • true: Enables CSRF protection tokens for additional hardening compared to the currently used custom header.
  • false: (Default) Disables CSRF protection tokens and enables legacy X-Requested-With header fallback.

엄격한 CSRF 토큰 적용#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: 현재 사용되는 사용자 정의 헤더에 비해 추가적인 강화를 위한 CSRF 보호 토큰을 활성화합니다. 사용자가 로그인하면 CSRF 토큰이 포함된 추가 쿠키가 생성됩니다.

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

This feature's config.json setting is "ExperimentalStrictCSRFEnforcement": false with options true and false.

개발자 플래그#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

현재 지원되는 값:

  • unsafe-eval: 루트 웹 앱에 unsafe-eval CSP 지시문을 추가하여 개발자 환경에서 더 많은 디버깅을 허용합니다.
  • unsafe-inline: 루트 웹 앱에 unsafe-inline CSP 지시문을 추가하여 개발자 환경에서 더 많은 디버깅을 허용합니다.
이 구성 설정은 기본적으로 비활성화되어 있으며 개발자 모드 가 활성화되어야 합니다.
This feature's config.json setting is "DeveloperFlags": "" with string input.

게시물 검색 활성화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "EnablePostSearch": true with options true and false.
Note

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

    • 데이터베이스 부하 감소: 게시물 검색이 활성화되면 모든 검색 쿼리가 데이터베이스에 추가 부하를 줍니다. 검색을 비활성화하면 이러한 쿼리가 줄어들어 데이터베이스 성능이 향상됩니다.
    • 메모리 사용량 감소: 검색 기능은 종종 메모리를 소비하는 게시물 인덱싱이 필요합니다. 검색을 비활성화하면 이 인덱스 유지에 필요한 메모리가 다른 용도로 사용될 수 있습니다.
    • 빠른 쓰기 작업: 게시물 검색이 활성화되면 새 게시물, 편집 또는 삭제 시마다 인덱싱을 업데이트해야 합니다. 검색을 비활성화하면 이러한 오버헤드를 피할 수 있습니다.
    • 성능 일관성: 검색 기능 없이는 잠재적 성능 병목 현상을 피하고 더 일관된 성능을 유지할 수 있습니다.
    • 시스템 유지 관리 간소화: 검색 인덱스 관리는 복잡하고 리소스 집약적일 수 있습니다. 검색을 비활성화하면 이 측면의 시스템 유지 관리가 간소화됩니다.
    • 단, Mattermost에서 메시지를 검색하는 기능은 많은 사용자에게 중요한 기능이며, 이 기능을 비활성화하면 사용자가 검색 상자를 사용하려 할 때 오류가 표시됩니다.

파일 검색 활성화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

Important

이 실험적 구성 설정은 사용자가 메시지에 첨부된 문서를 파일명으로 검색할 수 있게 합니다. 사용자가 문서 내용으로 검색할 수 있게 하려면 ExtractContent 구성 설정도 활성화해야 합니다. 자세한 내용은 내용으로 문서 검색 활성화 문서를 참조하세요. 문서 내용 검색은 Mattermost Server v5.35부터 사용 가능합니다.

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

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

This feature's config.json setting is "EnableFileSearch": true with options true and false.
Note

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

    • 인덱싱할 데이터 감소: 메시지 외에 파일을 인덱싱하면 검색 인덱스에서 처리하고 저장해야 하는 데이터 양이 늘어납니다.
    • 복잡한 쿼리 감소: 파일 검색은 메시지만 검색하는 것보다 더 복잡한 쿼리가 필요할 수 있으며, 이는 더 많은 리소스를 소비합니다.
    • IO 작업 감소: 파일 검색은 더 많은 입출력 작업을 발생시킬 수 있어 전반적인 디스크 성능에 영향을 줄 수 있습니다.
    • 단, Mattermost에서 파일을 검색하는 기능은 많은 사용자에게 중요한 기능이며, 이 기능을 비활성화하면 사용자가 검색 상자를 사용하려 할 때 오류가 표시됩니다.

사용자 상태 업데이트 활성화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

성능 향상을 위해 상태 업데이트를 끕니다. 상태 업데이트가 꺼지면 사용자는 메시지를 게시하는 짧은 시간 동안만, 그리고 메시지가 게시된 채널의 멤버들에게만 온라인으로 표시됩니다.

This feature's config.json setting is "EnableUserStatuses": true with options true and false.

WebSocket 보안 포트#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다. 이 설정을 변경하면 서버를 재시작해야 적용됩니다.

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

This feature's config.json setting is "WebsocketSecurePort": 443 with numerical input.
Note

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

WebSocket 포트#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다. 이 설정을 변경하면 서버를 재시작해야 적용됩니다.

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

This feature's config.json setting is WebsocketPort": 80 with numerical input.
Note

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

    • true: Enables local mode for mmctl.
    • false: (Default) Prevents local mode for mmctl.

mmctl 로컬 모드 활성화#

이 셀프 호스팅 배포 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

False: mmctl의 로컬 모드를 방지합니다.

This feature's config.json setting is "EnableLocalMode": false with options true and false.
Tip

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

mmctl 로컬 모드 소켓 위치 활성화#

이 셀프 호스팅 배포 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

아무것도 지정하지 않으면 서버와 mmctl이 가정하는 기본 경로는 /var/tmp/mattermost_local.socket 입니다.

This feature's config.json setting is "LocalModeSocketLocation": "/var/tmp/mattermost_local.socket" with string input.

기본 채널#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

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

Note

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

This feature's config.json setting is "ExperimentalDefaultChannels": [] with string array input consisting of channel names, such as ["announcement", "developers"].

실험적 작업 구성 설정#

셀프 호스팅 배포에서 데이터 보존이 활성화된 경우 오래된 게시물 삭제나 Elasticsearch를 통한 게시물 인덱싱 같은 주기적 작업을 Mattermost가 예약하고 완료하는 방식을 구성할 수 있습니다. 이 설정은 작업을 올바른 시간에 대기열에 넣는 서버인 스케줄러와 주어진 작업을 완료하는 서버인 워커로 지정되는 Mattermost 서버를 제어합니다.

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

고가용성 모드에서 Mattermost를 실행할 때는 일반적으로 하나 이상의 서버에서 RunJobs 를, 모든 서버에서 RunScheduler 를 활성화해야 합니다. 고가용성 클러스터 기반 배포에는 하나의 스케줄러와 하나 이상의 워커가 있습니다.

작업 실행#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

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

This feature's config.json setting is "RunJobs": true with options true and false.

스케줄러 실행#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

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

Warning

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

Tip

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

This feature's config.json setting is "RunScheduler": true with options true and false.

오래된 데이터베이스 작업 정리#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

완료된 오래된 데이터베이스 작업이 제거되는 임계값(일)을 정의합니다. 이 설정은 기본적으로 비활성화되어 있으며 활성화하려면 0 이상의 값으로 설정해야 합니다.

This feature's config.json setting is "JobSettings.CleanupJobsThresholdDays": -1 with numerical input.

오래된 데이터베이스 항목 정리#

이 설정은 데이터베이스의 구성에만 적용됩니다. System Console에서 사용할 수 없으며 mmctl을 통해 설정하거나 데이터베이스에서 직접 변경할 수 있습니다.

오래된 구성이 데이터베이스에서 제거되는 임계값(일)을 정의합니다.

This feature's config.json setting is "JobSettings.CleanupConfigThresholdDays": 30 with numerical input.

실험적 구성 설정

원문 보기
요약

제품 메뉴 → System Console → Experimental > Features에서 다음 실험적 구성 옵션을 검토하고 관리하세요: 셀프 호스팅 Mattermost를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다.

제품 메뉴 → System Console → Experimental > Features에서 다음 실험적 구성 옵션을 검토하고 관리하세요:

Tip

셀프 호스팅 Mattermost를 관리하는 시스템 관리자는 아래 표에 설명된 대로 config.json 파일을 편집할 수 있습니다. 각 구성 값에는 JSON 인식 도구를 사용하여 프로그래밍 방식으로 config.json 파일에서 값에 접근할 수 있는 JSON 경로가 포함됩니다. 예를 들어, LoginButtonColor 값은 LdapSettings 아래에 있습니다.

    • jq <https://stedolan.github.io/jq/>`__ 와 같은 도구를 사용하는 경우: cat config/config.json | jq '.LdapSettings.LoginButtonColor'</li><li>config.json 파일을 수동으로 편집할 때는 LdapSettings 와 같은 객체를 찾은 뒤 그 안에서 LoginButtonColor`` 키를 찾으세요.

#

실험적 System Console 구성 설정#

AD/LDAP 로그인 버튼 색상#

화이트 라벨링을 위한 AD/LDAP 로그인 버튼의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonColor": "" with string input.

AD/LDAP 로그인 버튼 테두리 색상#

화이트 라벨링을 위한 AD/LDAP 로그인 버튼 테두리의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonBorderColor": "" with string input.

AD/LDAP 로그인 버튼 텍스트 색상#

화이트 라벨링을 위한 AD/LDAP 로그인 버튼 텍스트의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonTextColor": "" with string input.
  • true: (Default) Users can change their sign-in method to any that is enabled on the server, either via their Profile or the APIs.
  • false: Users cannot change their sign-in method, regardless of which authentication options are enabled.

인증 방법 변경#

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

False: 활성화된 인증 옵션에 관계없이 사용자가 로그인 방법을 변경할 수 없습니다.

This feature's config.json setting is "ExperimentalEnableAuthenticationTransfer": true with options true and false.

링크 메타데이터 타임아웃#

링크 메타데이터를 반환하는 요청에 대한 구성 가능한 타임아웃을 추가합니다. 타임아웃이 만료되기 전에 메타데이터가 반환되지 않으면 메타데이터 없이 메시지가 게시됩니다. 이 타임아웃은 끊어진 URL과 느린 네트워크 연결에서의 잘못된 콘텐츠 유형 실패 케이스를 처리합니다.

This feature's config.json setting is "LinkMetadataTimeoutMilliseconds: 5000`` with numerical input.

이메일 일괄 처리 버퍼 크기#

단일 이메일에 일괄 처리되는 알림의 최대 수를 지정합니다.

Note
    • Mattermost 로그에 다음 오류가 표시되면 기본값에서 버퍼 크기를 늘리는 것을 권장합니다: Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail. 이 값을 늘리면 서버 성능에 영향을 주지 않고 이메일이 대기열에 쌓입니다.
    • 이메일 대기열이 구성된 이메일 일괄 처리 간격 을 초과하면 알림이 즉시 전송됩니다.
This feature's config.json setting is EmailBatchingBufferSize: 256`` with numerical input.

이메일 일괄 처리 간격#

일괄 처리 작업이 새 알림을 확인하는 최대 빈도(초)를 지정합니다.

Note
    • Mattermost 로그에 다음 오류가 표시되면 기본값에서 이메일 일괄 처리 간격을 줄이는 것을 권장합니다: Email batching job's receiving buffer was full. Please increase the EmailBatchingBufferSize. Falling back to sending immediate mail.
    • 일괄 처리 간격이 길수록 성능이 향상될 수 있습니다.
    • 이메일 대기열 이 구성된 이메일 일괄 처리 간격을 초과하면 알림이 즉시 전송됩니다.
This feature's config.json setting is EmailBatchingInterval": 30 with numerical input.

이메일 로그인 버튼 색상#

화이트 라벨링을 위한 이메일 로그인 버튼의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonColor": "" with string input.

이메일 로그인 버튼 테두리 색상#

화이트 라벨링을 위한 이메일 로그인 버튼 테두리의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonBorderColor": "" with string input.

이메일 로그인 버튼 텍스트 색상#

화이트 라벨링을 위한 이메일 로그인 버튼 텍스트의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonTextColor": "" with string input.
  • true: Ability for users to deactivate their own account from Settings > Advanced is enabled.
  • false: (Default) Ability for users to deactivate their own account is disabled.

계정 비활성화 활성화#

True: 사용자가 설정 > 고급 > 계정 비활성화에서 자신의 계정을 비활성화할 수 있습니다. 계정을 비활성화하면 확인 이메일이 발송됩니다. 이메일/비밀번호 인증 방식에서만 사용 가능하며, SAML 또는 AD/LDAP 인증 방식에서는 사용할 수 없습니다.

False: 사용자의 계정 자체 비활성화 기능이 비활성화됩니다.

This feature's config.json setting is "EnableUserDeactivation": false with options true and false.
  • true: Users can enable Automatic Replies in Settings > Notifications.
  • false: (Default) Disables the Automatic Direct Message Replies feature and hides it from Settings.

자동 답장 활성화#

True: 사용자가 설정 > 알림에서 자동 답장을 활성화할 수 있습니다. 다이렉트 메시지에 자동으로 발송될 사용자 정의 메시지를 설정합니다.

False: 자동 다이렉트 메시지 답장 기능을 비활성화하고 설정에서 숨깁니다.

This feature's config.json setting is "ExperimentalEnableAutomaticReplies": false with options true and false.

채널 열람 WebSocket 메시지 활성화#

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

This feature's config.json setting is "EnableChannelViewedMessages": true with options true and false.
Note

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

    • 데이터베이스 부하 감소: channel_viewed 이벤트가 비활성화되면 서버가 더 이상 이 이벤트를 데이터베이스에 기록할 필요가 없습니다. 이는 쓰기 및 업데이트 작업 수를 줄여줍니다.
    • 네트워크 트래픽 감소: 이 이벤트를 비활성화하면 서버와 클라이언트 간에 전송되는 메시지가 줄어듭니다.
    • 서버 CPU 사용량 감소: channel_viewed 이벤트 처리에는 데이터베이스 트랜잭션 및 네트워크 통신을 처리하는 CPU 리소스가 필요합니다.
    • 사용자 경험 향상: 서버 부하 및 네트워크 트래픽 감소로 로딩 시간이 빨라질 수 있습니다.
    • 단, 이 설정을 비활성화하면 채널의 읽음/읽지 않음 메시지 추적 등 일부 기능에 영향을 줍니다.
    • true: (Default) Enables leave/join system messages in the default town-square channel.
    • false: Disables leave/join messages from the default town-square channel.

기본 채널 나가기/참여 시스템 메시지 활성화#

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

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

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

This feature's config.json setting is "ExperimentalEnableDefaultChannelLeaveJoinMessages": true with options true and false.
  • true: Enables a hardened mode for Mattermost that makes user experience trade-offs in the interest of security.
  • false: (Default) Disables hardened mode.

강화 모드 활성화#

True: 보안을 위한 사용자 경험 트레이드오프가 적용된 Mattermost 강화 모드를 활성화합니다.

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

강화 모드 활성화 시 적용되는 변경 사항:

  • 로그인 실패 시 사용자명/비밀번호에 대한 구체적인 오류 메시지 대신 일반적인 오류 메시지가 반환됩니다.
  • 다중 인증(MFA) 가 활성화된 경우, 사용자의 MFA 활성화 여부 확인 경로가 항상 true를 반환합니다.
  • 비밀번호 재설정 시 SSO 계정을 Mattermost를 통해 재설정할 수 없다는 안내 없이 재설정 이메일이 발송되었다고 표시됩니다.
  • Mattermost는 클라이언트에 반환되기 전에 모든 500 오류를 정제합니다. 제공된 request_id 를 사용하여 사용자 오류와 서버 로그를 대조하세요.
  • 사용자명과 비밀번호로 인증된 일반 사용자는 override_username 또는 override_icon_url 같은 통합용 예약 게시물 속성을 사용할 수 없습니다.
This feature's config.json setting is "ExperimentalEnableHardenedMode": false with options true and false.
  • true: (Default) Enables the Display > Theme tab in Settings so users can select their theme.
  • false: Users cannot select a different theme. The Display > Theme tab is hidden in Settings.

테마 선택 활성화#

True: 설정의 표시 > 테마 탭을 활성화하여 사용자가 테마를 선택할 수 있게 합니다.

False: 사용자가 다른 테마를 선택할 수 없습니다. 설정의 표시 > 테마 탭이 숨겨집니다.

This feature's config.json setting is "EnableThemeSelection": true with options true and false.
  • true: (Default) Enables the Display > Theme > Custom Theme section in Settings.
  • false: Users cannot use a custom theme. The Display > Theme > Custom Theme section is hidden in Settings.

사용자 정의 테마 허용#

True: 설정의 표시 > 테마 > 사용자 정의 테마 섹션을 활성화합니다.

False: 사용자가 사용자 정의 테마를 사용할 수 없습니다. 설정의 표시 > 테마 > 사용자 정의 테마 섹션이 숨겨집니다.

This feature's config.json setting is "AllowCustomThemes": true with options true and false.

기본 테마#

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

This feature's config.json setting is "DefaultTheme": "default" with options "default", "organization", "mattermostDark", and "windows10".
  • true: (Default) Users are prompted with a tutorial when they open Mattermost for the first time after account creation.
  • false: The tutorial is disabled. Users are placed in Town Square when they open Mattermost for the first time after account creation.

튜토리얼 활성화#

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

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

This feature's config.json setting is "ServiceSettings.EnableTutorial": true with options true and false.
  • true: (Default) New Mattermost users are shown key tasks to complete as part of initial onboarding.
  • false: User onboarding tasks are disabled. Users are placed in Town Square when they open Mattermost for the first time after account creation.

온보딩 흐름 활성화#

True: 새 Mattermost 사용자에게 초기 온보딩의 일환으로 완료해야 할 주요 작업이 표시됩니다.

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

This feature's config.json setting is "ServiceSettings.EnableOnboardingFlow": true with options true and false.

사용자 입력 중 메시지 활성화#

이 설정은 웹 브라우저 또는 데스크톱 앱에서 Mattermost 사용 시 메시지 입력창 아래에 "입력 중..." 메시지를 표시할지 여부를 결정합니다.

This feature's config.json setting is "EnableUserTypingMessages": true with options true and false.
Note

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

    • 서버 부하 감소: 입력 이벤트는 추가적인 WebSocket 트래픽을 발생시킵니다. 비활성화하면 서버가 처리해야 하는 데이터 양이 줄어듭니다.
    • 네트워크 트래픽 감소: 입력 이벤트가 활성화되면 키 입력마다 네트워크 이벤트가 발생합니다. 이를 비활성화하면 네트워크를 통해 전송되는 정보의 양이 줄어듭니다.
    • 클라이언트 성능 향상: 클라이언트 측에서 입력 이벤트 처리에 리소스가 필요합니다. 이 이벤트를 처리하지 않으면 클라이언트가 더 빠르게 응답하고 메모리와 CPU 사용량이 줄어듭니다.

사용자 입력 타임아웃#

이 설정은 "입력 중..." 메시지가 업데이트되는 빈도(밀리초)를 정의합니다.

This feature's config.json setting is "TimeBetweenUserTypingUpdatesMilliseconds": 5000 with numerical input.

사용자 상태 및 프로필 조회 폴링 간격#

사용자 상태 및 프로필을 주기적으로 조회하는 사이의 대기 시간(밀리초)을 구성합니다. 0 으로 설정하면 비활성화됩니다.

This feature's config.json setting is "ExperimentalSettings.UsersStatusAndProfileFetchingPollIntervalMilliseconds": 3000 with numerical input.
Note

이 구성 설정 값을 줄이면 Mattermost가 업데이트된 사용자 프로필 정보를 더 자주 확인하고 가져옵니다. 값을 줄이면 오래되거나 누락된 데이터로 인해 채널에서 사용자명이 Someone으로 표시되는 경우를 줄이는 데 도움이 됩니다.

기본 팀#

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

기본 팀의 URL이 https://example.mattermost.com/myteam/ 인 경우, config.json 에서 값을 myteam 으로 설정하세요.

This feature's config.json setting is "ExperimentalPrimaryTeam": "" with string input.

SAML 로그인 버튼 색상#

화이트 라벨링을 위한 SAML 로그인 버튼의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonColor": "" with string input.

SAML 로그인 버튼 테두리 색상#

화이트 라벨링을 위한 SAML 로그인 버튼 테두리의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonBorderColor": "" with string input.

SAML 로그인 버튼 텍스트 색상#

화이트 라벨링을 위한 SAML 로그인 버튼 텍스트의 색상을 지정합니다. #으로 시작하는 hex 코드를 사용하세요. 이 설정은 모바일 앱에만 적용됩니다.

This feature's config.json setting is "LoginButtonTextColor": "" with string input.
  • true: Channel and team name appears in email notification subject lines.
  • false: (Default) Only team name appears in email notification subject line.

이메일 알림에 채널 이름 사용#

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

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

This feature's config.json setting is "UseChannelInEmailNotifications": false with options true and false.

사용자 자리 비움 상태 타임아웃#

이 설정은 사용자가 Mattermost를 사용하지 않을 때 상태 표시가 "자리 비움"으로 변경되기까지의 시간(초)을 정의합니다.

This feature's config.json setting is "UserStatusAwayTimeout": 300 with numerical input.

브라우저 포커스 복귀 시 데이터 재조회 비활성화#

이 설정은 브라우저 포커스 복귀 시 채널 및 채널 멤버를 다시 조회하는 기능을 비활성화합니다.

True: 브라우저가 포커스를 다시 받을 때 Mattermost가 채널 및 채널 멤버를 재조회하지 않습니다. 채널 및 멤버가 많은 사용자의 성능이 향상될 수 있습니다.

False: (기본값) 브라우저가 포커스를 다시 받을 때 Mattermost가 채널 및 채널 멤버를 재조회합니다.

This feature's config.json setting is "ExperimentalSettings.DisableRefetchingOnBrowserFocus": false with options true and false.

절전 모드 해제 재연결 핸들러 비활성화#

이 설정은 컴퓨터 절전 모드 해제 감지 및 데이터 재조회 시도를 비활성화합니다.

True: Mattermost가 컴퓨터 절전 모드 해제를 감지하거나 데이터를 재조회하려 하지 않습니다. 앱이 전송하는 일반적인 네트워크 트래픽을 줄일 수 있습니다.

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

This feature's config.json setting is "ExperimentalSettings.DisableWakeUpReconnectHandler": false with options true and false.

채널 자동 완성 지연#

이 설정은 메시지 작성 중 물결표(~) 입력 시 채널 링크 자동 완성이 즉시 실행될지 여부를 제어합니다. 이 설정은 문장 부호로 물결표를 사용하는 사람들에게 ~town-square 와 같은 채널 자동 완성을 덜 방해적으로 만듭니다.

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

False: (기본값) 사용자가 물결표를 입력하면 즉시 자동 완성이 나타납니다.

This feature's config.json setting is "ExperimentalSettings.DelayChannelAutocomplete": false with options true and false.

YouTube 참조 정책#

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

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

False: (기본값) 참조 정책이 no-referrer 로 설정되어 소스 URL을 공개하지 않아 사용자 개인 정보를 보호하지만, 분석 도구에서 사용자 참여 및 트래픽 소스 추적 기능이 제한됩니다.

This feature's config.json setting is "ExperimentalSettings.YoutubeReferrerPolicy": false with options true and false.

실험적 Bleve 구성 설정#

Important

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

다음 구성 설정은 System Console에서 Experimental > Bleve로 이동하거나 아래 표에 설명된 대로 config.json 파일을 편집하여 접근할 수 있습니다:

  • true: The indexing of new posts occurs automatically.
  • false: (Default) The indexing of new posts does not occur automatically.

Bleve 인덱싱 활성화#

True: 새 게시물이 자동으로 인덱싱됩니다. 검색 쿼리에 Bleve 활성화 가 활성화될 때까지 검색 쿼리에 Bleve 검색이 사용되지 않습니다.

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

This feature's config.json setting is "EnableIndexing": false with options true and false.

인덱스 디렉터리#

Bleve 인덱스를 저장하는 데 사용할 디렉터리 경로입니다.

Tip

Bleve 인덱스 디렉터리 경로는 반드시 mattermost 디렉터리 내에 있을 필요는 없습니다. mattermost 디렉터리 외부에 있는 경우, Mattermost 업그레이드 시 이 파일들을 보존하거나 재인덱싱하기 위한 추가 단계가 필요하지 않습니다. 자세한 내용은 Mattermost 서버 업그레이드 문서를 참조하세요.

This feature's config.json setting is "IndexDir": "" with string input.

즉시 대량 인덱싱#

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

인덱스 삭제#

인덱스 삭제를 선택하여 Bleve 인덱스 디렉터리의 내용을 제거합니다. 기존 데이터베이스의 대량 인덱스가 재구성될 때까지 검색 결과가 불완전할 수 있습니다.

  • true: Search queries will use bleve search.
  • false: (Default) Search queries will not use bleve search.

검색 쿼리에 Bleve 활성화#

True: 검색 쿼리에 Bleve 검색이 사용됩니다.

False: 검색 쿼리에 Bleve 검색이 사용되지 않습니다.

This feature's config.json setting is "EnableSearching": false with options true and false.
  • true: Autocomplete queries will use bleve search.
  • false: (Default) Autocomplete queries will not use bleve search.

자동 완성 쿼리에 Bleve 활성화#

True: 자동 완성 쿼리에 Bleve 검색이 사용됩니다.

False: 자동 완성 쿼리에 Bleve 검색이 사용되지 않습니다.

This feature's config.json setting is "EnableAutocomplete": false with options true and false.

실험적 감사 로그 구성 설정#

Compliance > Audit Logging으로 이동하거나 config.json 파일에서 다음 설정을 활성화하여 감사 이벤트를 출력합니다.

Note

감사 로그 활성화 및 구성 기능은 현재 베타 상태입니다.

고급 로깅#

Mattermost Cloud 배포에서 콘솔, 로컬 파일, syslog, TCP 소켓 대상의 조합에 로그 및 감사 레코드를 출력합니다. 로깅 옵션에 대한 자세한 내용은 고급 로깅 문서를 참조하세요.

감사 로그 활성화#

셀프 호스팅 인스턴스에서 감사 로그가 활성화되면, 아래에 정의된 대로 파일 순환 관리를 위한 크기, 백업 간격, 압축, 최대 보존 기간 및 타임스탬프를 지정할 수 있습니다. 감사 이벤트와 AD/LDAP 이벤트에 대해 독립적으로 설정할 수 있습니다.

True: 감사 로그 파일이 활성화되고, 셀프 호스팅 배포에서 감사 파일이 로컬 파일로 기록됩니다.

False: 감사 로그 파일이 활성화되지 않고, 셀프 호스팅 배포에서 감사 로그가 로컬 파일로 기록되지 않습니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileEnabled": false", with options true and false.

파일 이름#

셀프 호스팅 배포의 감사 파일 경로를 지정합니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileName": "" with string input consisting of a user-defined path (e.g. /var/log/mattermost_audit.log).

최대 파일 크기#

셀프 호스팅 배포에서 파일 순환이 발생하기 전까지 파일이 커질 수 있는 최대 크기(메가바이트)입니다. 기본값은 100 입니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileMaxSizeMB": 100 with numerical input.

최대 파일 보존 기간#

셀프 호스팅 배포에서 파일 순환이 발생하기 전까지 파일이 도달할 수 있는 최대 보존 기간(일)입니다. 기본값은 0 으로 제한 없음을 의미합니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileMaxAgeDays": 0 with numerical input.

최대 파일 백업 수#

셀프 호스팅 배포에서 유지되는 순환 파일의 최대 수입니다. 가장 오래된 파일이 먼저 삭제됩니다. 기본값은 0 으로 백업 수 제한 없음을 의미합니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileMaxBackups": 0 with numerical input.

파일 압축#

true 이면 셀프 호스팅 배포에서 순환된 파일이 gzip 으로 압축됩니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileCompress": false with options true and false.

최대 파일 큐#

이 설정은 셀프 호스팅 배포에서 파일에 쓸 때 언제든지 대기/버퍼링할 수 있는 감사 레코드 수를 결정합니다. 기본값은 1000 레코드입니다.

서버 로그에서 감사 쓰기 실패가 보이지 않는 한 기본값을 유지할 수 있습니다.

This feature's config.json setting is ".ExperimentalAuditSettings.FileMaxQueueSize": 1000 with numerical input.

인증서#

Cloud Enterprise 고객은 Syslog 또는 TCP 로깅 대상의 감사 로그 암호화를 위한 인증서를 업로드하고 관리할 수 있습니다. 인증서 업로드 기능은 기능 플래그 ExperimentalAuditSettingsSystemConsoleUI 가 활성화된 경우에만 사용 가능합니다.

System Console > Audit Log Settings > Certificate로 이동하여 파일/인증서 제거를 선택해 System Console에서 인증서 PEM 파일을 업로드합니다. 인증서 파일은 파일 스토어나 파일 시스템 로컬에 저장할 수 있습니다.

셀프 호스팅 전용 실험적 구성 설정#

다음 셀프 호스팅 구성 설정은 아래 표에 설명된 대로 config.json 파일을 편집하여 접근할 수 있습니다. 이 구성 설정들은 System Console을 통해 접근할 수 없습니다.

Tip

아래의 각 구성 값에는 JSON 인식 도구를 사용하여 프로그래밍 방식으로 config.json 파일에서 값에 접근할 수 있는 JSON 경로가 포함됩니다. 예를 들어, SiteURL 값은 ServiceSettings 아래에 있습니다.

    • jq <https://stedolan.github.io/jq/>`__ 와 같은 도구를 사용하는 경우: cat config/config.json | jq '.ServiceSettings.SiteURL'</li><li>config.json 파일을 수동으로 편집할 때는 ServiceSettings 키를 찾은 뒤 그 안에서 SiteURL`` 키를 찾으세요.

허용된 테마#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "AllowedThemes": [] with string array input consisting of the options "default", "organization", "mattermostDark", and "windows10", such as ["mattermostDark", "windows10"].

파일 위치#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "FileLocation": "export" with string input.

푸시 알림 버퍼#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature’s config.json setting is "PushNotificationBuffer": 1000" with numerical input.

시스템 관리자 제한#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: (Cloud 배포의 기본값) 시스템 관리자가 System Console에서 서버 구성 설정의 일부를 보거나 수정하는 것을 제한합니다. 온프레미스 설치에는 권장하지 않습니다. 이는 사용자에게 시스템 관리자 역할을 부여하되 특정 작업을 Cloud 관리자만 수행할 수 있도록 Mattermost Private Cloud를 지원하기 위한 설정입니다.

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

This feature's config.json setting is "RestrictSystemAdmin": "false" with options true and false.
Note

서버 구성 설정의 일부를 보거나 수정하는 것을 시스템 관리자에게 제한하는 기능은 현재 베타 상태입니다.

    • true: Enables client-side certification for your Mattermost server.
    • false: (Default) Client-side certification is disabled.

클라이언트 측 인증서 인증 활성화#

Important

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

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

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

This feature's config.json setting is "ClientSideCertEnable": false with options true and false.
  • primary: After the client side certificate is verified, user's email is retrieved from the certificate and is used to log in without a password.
  • secondary: (Default) After the client side certificate is verified, user's email is retrieved from the certificate and matched against the one supplied by the user. If they match, the user logs in with regular email/password credentials.

클라이언트 측 인증서 로그인 방법#

Important

인증서 기반 인증은 Mattermost v11.0부터 더 이상 사용되지 않습니다. 이 설정은 Mattermost v11.0부터 더 이상 작동하지 않으며 기본값을 유지해야 합니다.

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

Primary: 클라이언트 측 인증서가 확인된 후 인증서에서 사용자의 이메일이 검색되어 비밀번호 없이 로그인하는 데 사용됩니다.

Secondary: (기본값) 클라이언트 측 인증서가 확인된 후 인증서에서 사용자의 이메일이 검색되어 사용자가 제공한 이메일과 비교됩니다. 일치하면 사용자가 일반 이메일/비밀번호 자격 증명으로 로그인합니다.

This feature's config.json setting is "ClientSideCertCheck": "secondary" with options "primary" and "secondary".

내보내기 출력 디렉터리#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting under the ExportSettings section is Directory: ./export with string input.

내보내기 보존 기간(일)#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

내보낸 파일을 삭제하기 전에 보존하는 일 수입니다.

This feature's config.json setting under the ExportSettings section is RetentionDays: 30 with numerical input.

최대 이미지 해상도#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "MaxImageResolution": 33177600 with numerical input.

최대 이미지 디코더 동시성#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

동시에 디코딩할 수 있는 이미지 수를 나타냅니다. 기본값 -1 은 Mattermost가 현재 CPU 수를 자동으로 사용하도록 구성합니다.

Note
    • 이 구성 설정은 서버의 총 메모리 소비에 영향을 줍니다. 단일 이미지의 최대 메모리는 MaxImageResolution <em> 24 바이트 로 결정되며, 기본 최대 이미지 해상도 값은 33MB입니다.
    • 따라서 33MB </em> MaxImageDecoderConcurrency <em> 24 가 서버의 총 메모리보다 작아야 합니다.
    • 예를 들어, 4코어 서버의 경우 이미지 처리를 위해 최소 33 </em> 4 * 24 = 3168MB 의 메모리를 남겨두어야 합니다. 그렇지 않으면 MaxImageResolution 구성 설정을 조정하여 이미지 처리에 필요한 메모리 양을 조절하세요.
This feature's config.json setting is "MaxImageDecoderConcurrency": "-1" with numerical input.

초기 폰트#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

색상 배경의 자동 생성 프로필 사진에 사용되는 폰트입니다.

This feature's config.json setting is "InitialFont": "luximbi.ttf" with string input.
  • true: Use Signature Version 2 Signing Process.
  • false: (Default) Use Signature Version 4 Signing Process.

Amazon S3 서명 v2#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

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

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

This feature's config.json setting is "AmazonS3SignV2": false with options true and false.

Amazon S3 경로#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature’s config.json setting is "AmazonS3PathPrefix: "" with string input.

GitLab 범위#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "Scope": "" with string input.

Global Relay SMTP 서버 타임아웃#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

SMTP 서버에 대한 연결 시도가 중단되기까지 경과할 수 있는 시간(초)입니다. 기본값은 1800초입니다.

This feature's config.json setting is "GlobalRelaySettings.SMTPServerTimeout": "1800" with numerical input.

Google 범위#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "Scope": "profile email" with string input.

가져오기 입력 디렉터리#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting under the ImportSettings section is Directory: ./import with string input.

가져오기 보존 기간(일)#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

가져온 파일을 삭제하기 전에 보존하는 일 수입니다.

This feature's config.json setting under the ImportSettings section is RetentionDays: 30 with numerical input.

타임스탬프부터 내보내기#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

데이터를 내보낼 Unix 타임스탬프(에포크 이후 초, UTC)를 설정합니다.

This feature's config.json setting is "ExportFromTimestamp": 0 with numerical input.

Entra ID 범위#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "Scope": "User.Read" with string input.
  • true: Enables plugin uploads by system admins at Plugins > Management.
  • false: (Default) Disables plugin uploads on your Mattermost server.

플러그인 업로드 활성화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: 시스템 관리자가 플러그인 > 관리에서 플러그인을 업로드할 수 있습니다. 플러그인을 업로드할 계획이 없는 경우 false 로 설정하여 서버에 설치되는 플러그인을 제어하세요. 자세한 내용은 문서 를 참조하세요.

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

This feature's config.json setting is "EnableUploads": false with options true and false.
  • true: Enables downloading and installing a plugin from a remote URL.
  • false: (Default) Disables downloading and installing a plugin from a remote URL.

비보안 다운로드 URL 허용#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: 원격 URL에서 플러그인을 다운로드하고 설치할 수 있습니다.

False: 원격 URL에서 플러그인 다운로드 및 설치가 비활성화됩니다.

This feature's config.json setting is "AllowInsecureDownloadUrl": false with options true and false.
  • true: (Default) Enables plugin health check to ensure all plugins are periodically monitored, and restarted or deactivated based on their health status.
  • false: Disables plugin health check on your Mattermost server.

플러그인 상태 확인 활성화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

False: Mattermost 서버에서 플러그인 상태 확인이 비활성화됩니다.

This feature's config.json setting is "EnableHealthCheck": true with options true and false.

플러그인 디렉터리#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

플러그인 파일의 위치입니다. 비어 있으면 ./plugins 디렉터리에 저장됩니다. 설정한 경로가 존재해야 하며 Mattermost에 쓰기 권한이 있어야 합니다.

This feature's config.json setting is "Directory": "./plugins" with string input.

클라이언트 플러그인 디렉터리#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "ClientDirectory": "./client/plugins" with string input.

범위 지정 IDP 공급자 ID#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "ScopingIDPProviderId": "" with string input.

범위 지정 IDP 공급자 이름#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

사용자의 범위 지정 ID 공급자 ID와 연관된 이름을 추가합니다.

This feature's config.json setting is "ScopingIDPName": "" with string input.
  • default_off: (Default) Disables the unread channels sidebar section for all users by default. Users can enable it in Settings > Sidebar > Group unread channels separately.
  • default_on: Enables the unread channels sidebar section for all users by default. Users can disable it in Settings > Sidebar > Group unread channels separately.

읽지 않은 채널 그룹화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

이 설정은 새 사이드바에만 적용됩니다. System Console에서 이 기능을 보거나 활성화하려면 레거시 사이드바 활성화 구성 설정을 비활성화해야 합니다.

기본값 꺼짐: 기본적으로 모든 사용자의 읽지 않은 채널 사이드바 섹션을 비활성화합니다. 사용자는 설정 > 사이드바 > 읽지 않은 채널 별도로 그룹화에서 활성화할 수 있습니다.

기본값 켜짐: 기본적으로 모든 사용자의 읽지 않은 채널 사이드바 섹션을 활성화합니다. 사용자는 설정 > 사이드바 > 읽지 않은 채널 별도로 그룹화에서 비활성화할 수 있습니다.

This feature's config.json setting is "ExperimentalGroupUnreadChannels": "default_off" with options "default_off" and "default_on".
  • true: Users can assign channels to new or existing channel categories when creating or renaming channels.
  • false: (Default) Disables the ability to assign channels to new or existing channel categories when creating or renaming channels.

채널 카테고리 정렬 활성화#

Mattermost v10.10부터 이 실험적 기능이 활성화되면 사용자가 채널을 만들거나 이름을 바꿀 때 새 채널 카테고리 또는 기존 채널 카테고리에 채널을 할당할 수 있습니다.

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

True: 사용자가 채널을 만들거나 이름을 바꿀 때 새 채널 카테고리 또는 기존 채널 카테고리에 채널을 할당할 수 있습니다.

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

This feature's config.json setting is "ExperimentalEnableChannelCategorySorting": false with options true and false.
  • true: Enables CSRF protection tokens for additional hardening compared to the currently used custom header.
  • false: (Default) Disables CSRF protection tokens and enables legacy X-Requested-With header fallback.

엄격한 CSRF 토큰 적용#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

True: 현재 사용되는 사용자 정의 헤더에 비해 추가적인 강화를 위한 CSRF 보호 토큰을 활성화합니다. 사용자가 로그인하면 CSRF 토큰이 포함된 추가 쿠키가 생성됩니다.

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

This feature's config.json setting is "ExperimentalStrictCSRFEnforcement": false with options true and false.

개발자 플래그#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

현재 지원되는 값:

  • unsafe-eval: 루트 웹 앱에 unsafe-eval CSP 지시문을 추가하여 개발자 환경에서 더 많은 디버깅을 허용합니다.
  • unsafe-inline: 루트 웹 앱에 unsafe-inline CSP 지시문을 추가하여 개발자 환경에서 더 많은 디버깅을 허용합니다.
이 구성 설정은 기본적으로 비활성화되어 있으며 개발자 모드 가 활성화되어야 합니다.
This feature's config.json setting is "DeveloperFlags": "" with string input.

게시물 검색 활성화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

This feature's config.json setting is "EnablePostSearch": true with options true and false.
Note

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

    • 데이터베이스 부하 감소: 게시물 검색이 활성화되면 모든 검색 쿼리가 데이터베이스에 추가 부하를 줍니다. 검색을 비활성화하면 이러한 쿼리가 줄어들어 데이터베이스 성능이 향상됩니다.
    • 메모리 사용량 감소: 검색 기능은 종종 메모리를 소비하는 게시물 인덱싱이 필요합니다. 검색을 비활성화하면 이 인덱스 유지에 필요한 메모리가 다른 용도로 사용될 수 있습니다.
    • 빠른 쓰기 작업: 게시물 검색이 활성화되면 새 게시물, 편집 또는 삭제 시마다 인덱싱을 업데이트해야 합니다. 검색을 비활성화하면 이러한 오버헤드를 피할 수 있습니다.
    • 성능 일관성: 검색 기능 없이는 잠재적 성능 병목 현상을 피하고 더 일관된 성능을 유지할 수 있습니다.
    • 시스템 유지 관리 간소화: 검색 인덱스 관리는 복잡하고 리소스 집약적일 수 있습니다. 검색을 비활성화하면 이 측면의 시스템 유지 관리가 간소화됩니다.
    • 단, Mattermost에서 메시지를 검색하는 기능은 많은 사용자에게 중요한 기능이며, 이 기능을 비활성화하면 사용자가 검색 상자를 사용하려 할 때 오류가 표시됩니다.

파일 검색 활성화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

Important

이 실험적 구성 설정은 사용자가 메시지에 첨부된 문서를 파일명으로 검색할 수 있게 합니다. 사용자가 문서 내용으로 검색할 수 있게 하려면 ExtractContent 구성 설정도 활성화해야 합니다. 자세한 내용은 내용으로 문서 검색 활성화 문서를 참조하세요. 문서 내용 검색은 Mattermost Server v5.35부터 사용 가능합니다.

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

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

This feature's config.json setting is "EnableFileSearch": true with options true and false.
Note

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

    • 인덱싱할 데이터 감소: 메시지 외에 파일을 인덱싱하면 검색 인덱스에서 처리하고 저장해야 하는 데이터 양이 늘어납니다.
    • 복잡한 쿼리 감소: 파일 검색은 메시지만 검색하는 것보다 더 복잡한 쿼리가 필요할 수 있으며, 이는 더 많은 리소스를 소비합니다.
    • IO 작업 감소: 파일 검색은 더 많은 입출력 작업을 발생시킬 수 있어 전반적인 디스크 성능에 영향을 줄 수 있습니다.
    • 단, Mattermost에서 파일을 검색하는 기능은 많은 사용자에게 중요한 기능이며, 이 기능을 비활성화하면 사용자가 검색 상자를 사용하려 할 때 오류가 표시됩니다.

사용자 상태 업데이트 활성화#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

성능 향상을 위해 상태 업데이트를 끕니다. 상태 업데이트가 꺼지면 사용자는 메시지를 게시하는 짧은 시간 동안만, 그리고 메시지가 게시된 채널의 멤버들에게만 온라인으로 표시됩니다.

This feature's config.json setting is "EnableUserStatuses": true with options true and false.

WebSocket 보안 포트#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다. 이 설정을 변경하면 서버를 재시작해야 적용됩니다.

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

This feature's config.json setting is "WebsocketSecurePort": 443 with numerical input.
Note

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

WebSocket 포트#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다. 이 설정을 변경하면 서버를 재시작해야 적용됩니다.

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

This feature's config.json setting is WebsocketPort": 80 with numerical input.
Note

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

    • true: Enables local mode for mmctl.
    • false: (Default) Prevents local mode for mmctl.

mmctl 로컬 모드 활성화#

이 셀프 호스팅 배포 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

False: mmctl의 로컬 모드를 방지합니다.

This feature's config.json setting is "EnableLocalMode": false with options true and false.
Tip

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

mmctl 로컬 모드 소켓 위치 활성화#

이 셀프 호스팅 배포 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

아무것도 지정하지 않으면 서버와 mmctl이 가정하는 기본 경로는 /var/tmp/mattermost_local.socket 입니다.

This feature's config.json setting is "LocalModeSocketLocation": "/var/tmp/mattermost_local.socket" with string input.

기본 채널#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

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

Note

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

This feature's config.json setting is "ExperimentalDefaultChannels": [] with string array input consisting of channel names, such as ["announcement", "developers"].

실험적 작업 구성 설정#

셀프 호스팅 배포에서 데이터 보존이 활성화된 경우 오래된 게시물 삭제나 Elasticsearch를 통한 게시물 인덱싱 같은 주기적 작업을 Mattermost가 예약하고 완료하는 방식을 구성할 수 있습니다. 이 설정은 작업을 올바른 시간에 대기열에 넣는 서버인 스케줄러와 주어진 작업을 완료하는 서버인 워커로 지정되는 Mattermost 서버를 제어합니다.

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

고가용성 모드에서 Mattermost를 실행할 때는 일반적으로 하나 이상의 서버에서 RunJobs 를, 모든 서버에서 RunScheduler 를 활성화해야 합니다. 고가용성 클러스터 기반 배포에는 하나의 스케줄러와 하나 이상의 워커가 있습니다.

작업 실행#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

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

This feature's config.json setting is "RunJobs": true with options true and false.

스케줄러 실행#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

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

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

Warning

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

Tip

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

This feature's config.json setting is "RunScheduler": true with options true and false.

오래된 데이터베이스 작업 정리#

이 설정은 System Console에서 사용할 수 없으며 config.json 에서만 설정할 수 있습니다.

완료된 오래된 데이터베이스 작업이 제거되는 임계값(일)을 정의합니다. 이 설정은 기본적으로 비활성화되어 있으며 활성화하려면 0 이상의 값으로 설정해야 합니다.

This feature's config.json setting is "JobSettings.CleanupJobsThresholdDays": -1 with numerical input.

오래된 데이터베이스 항목 정리#

이 설정은 데이터베이스의 구성에만 적용됩니다. System Console에서 사용할 수 없으며 mmctl을 통해 설정하거나 데이터베이스에서 직접 변경할 수 있습니다.

오래된 구성이 데이터베이스에서 제거되는 임계값(일)을 정의합니다.

This feature's config.json setting is "JobSettings.CleanupConfigThresholdDays": 30 with numerical input.