사이트 구성 설정

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

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

팁

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

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

맞춤 설정

시스템 콘솔에서 Site Configuration > Customization으로 이동해 다음 구성 설정에 접근합니다.

사이트 이름 (Site name)

로그인 화면과 사용자 인터페이스에 표시되는 사이트 이름입니다.

문자열 입력. 최대 30자. 기본값은 Mattermost입니다

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: TeamSettings > SiteName
  • 환경 변수: MM_TEAMSETTINGS_SITENAME

사이트 설명 (Site description)

로그인 양식 위에 표시되는 텍스트입니다. 지정하지 않으면 "Log in" 문구가 표시됩니다.

문자열 입력.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: TeamSettings > CustomDescriptionText
  • 환경 변수: MM_TEAMSETTINGS_CUSTOMDESCRIPTIONTEXT

맞춤 브랜딩 활성화 (Enable custom branding)

  • true: 로그인 페이지에 맞춤 이미지와 텍스트를 표시합니다
  • false: (기본값) 맞춤 브랜딩을 사용하지 않습니다

브랜딩 옵션에 대한 자세한 내용은 맞춤 브랜드 이미지와 맞춤 브랜드 텍스트 구성 설정도 참고하세요.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: TeamSettings > EnableCustomBrand > false
  • 환경 변수: MM_TEAMSETTINGS_ENABLECUSTOMBRAND

맞춤 브랜드 이미지 (Custom brand image)

로그인 페이지에 표시할 JPG 이미지입니다. 이 이미지는 반드시 시스템 콘솔을 통해 업로드해야 합니다. 해당하는 config.json 설정은 없습니다. 파일 크기는 2MB 미만이어야 합니다.

이미지를 표시하려면 맞춤 브랜딩 활성화가 true로 설정되어 있어야 합니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: N/A
  • 환경 변수: N/A

맞춤 브랜드 텍스트 (Custom brand text)

로그인 페이지에서 Custom brand image 아래에 표시되는 텍스트입니다. Mattermost 메시지와 동일한 마크다운 서식으로 이 텍스트의 서식을 지정할 수 있습니다.

문자열 입력. 최대 500자. 텍스트를 표시하려면 맞춤 브랜딩 활성화가 true로 설정되어 있어야 합니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: TeamSettings > CustomBrandText
  • 환경 변수: MM_TEAMSETTINGS_CUSTOMBRANDTEXT
  • true: (기본값) 채널 헤더의 Help 메뉴 아래에 Mattermost 커뮤니티 링크가 Ask the community로 표시됩니다.
  • false: 링크가 표시되지 않습니다.

이 링크는 모바일 앱에는 표시되지 않습니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: SupportSettings > EnableAskCommunityLink > true
  • 환경 변수: MM_SUPPORTSETTINGS_ENABLEASKCOMMUNITYLINK

이 필드는 로그인 및 가입 페이지의 Help 링크와 채널 헤더의 Help 메뉴 아래 Help Resources 링크에 사용할 URL을 설정합니다.

문자열 입력. 기본값은 https://about.mattermost.com/default-help/입니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: SupportSettings > HelpLink
  • 환경 변수: MM_SUPPORTSETTINGS_HELPLINK
참고

이 값이 비어 있으면 로그인 및 가입 페이지에서 Help 링크가 숨겨집니다. 다만 Help 메뉴의 Help Resources 링크는 그대로 유지됩니다.

이 필드는 자체 호스팅 사이트의 이용 약관 URL을 설정합니다. 약관 링크는 가입 및 로그인 페이지 하단에 표시됩니다.

기본 URL은 mattermost.com에서 제공하는 이용 약관 페이지로 연결됩니다. 여기에는 Mattermost 소프트웨어가 최종 사용자에게 제공되는 조건을 설명하는 Mattermost 이용 정책(Acceptable Use Policy)이 포함됩니다. 기본 링크를 자체 약관으로 변경하는 경우, 최종 사용자가 Mattermost 이용 정책을 인지할 수 있도록 새 약관에 기본 약관 링크를 반드시 포함해야 합니다.

문자열 입력. 기본값은 https://about.mattermost.com/default-terms/입니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: SupportSettings > TermsOfServiceLink
  • 환경 변수: MM_SUPPORTSETTINGS_TERMSOFSERVICELINK
참고
  • Mattermost 구독 고객은 Mattermost와의 계약 조건에 따라 이용 정책(Acceptable Use Policy)을 자체 이용 정책 또는 행동 정책으로 대체하거나 재정의할 수 있습니다. 다만 자체 약관이 이용 정책을 포함하거나 그에 상응하는 조항을 담고 있어야 합니다. 제공하는 서비스의 이용에 관한 자체 약관을 추가하기 위해 기본 링크를 변경하는 경우, 최종 사용자가 Mattermost 소프트웨어에 대한 Mattermost 이용 정책을 인지할 수 있도록 새 약관에 기본 약관 링크를 포함해야 합니다.
  • 이 설정은 자체 호스팅 배포에만 적용되며, About Mattermost 창의 Terms of Use 링크는 변경하지 않습니다.

이 필드는 자체 호스팅 사이트의 개인정보 처리방침 URL을 설정합니다. 처리방침 링크는 가입 및 로그인 페이지 하단에 표시됩니다. 이 필드가 비어 있으면 링크가 표시되지 않습니다.

문자열 입력. 기본값은 https://about.mattermost.com/default-privacy-policy/입니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: SupportSettings > PrivacyPolicyLink
  • 환경 변수: MM_SUPPORTSETTINGS_PRIVACYPOLICYLINK
참고
  • 이 설정은 자체 호스팅 배포에만 적용되며, About Mattermost 창의 Privacy Policy 링크는 변경하지 않습니다.

이 필드는 자체 호스팅 사이트에 대한 일반 정보를 담은 페이지의 URL을 설정합니다. About 페이지 링크는 가입 및 로그인 페이지 하단에 표시됩니다. 이 필드가 비어 있으면 링크가 표시되지 않습니다.

문자열 입력. 기본값은 https://about.mattermost.com/default-about/입니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: SupportSettings > AboutLink
  • 환경 변수: MM_SUPPORTSETTINGS_ABOUTLINK
참고

이 설정은 자체 호스팅 배포에만 적용됩니다.

Mattermost 로그인 페이지에서 Forgot Password 링크가 활성화되어 있으면, 사용자는 비밀번호를 복구하거나 변경할 수 있는 맞춤 URL로 이동합니다.

Mattermost의 기본 비밀번호 재설정 워크플로를 사용하려면 이 필드를 비워 두세요.

  • 시스템 콘솔 경로: Site Configuration > Forgot password custom link
  • config.json 설정: SupportSettings > ForgetPasswordLink
  • 환경 변수: MM_SUPPORTSETTINGS_FORGETPASSWORDLINK
참고

이 구성 설정은 웹, 데스크톱 앱, 모바일 앱을 포함한 모든 Mattermost 클라이언트에 적용됩니다. 클라이언트에서 Forgot Password 링크를 표시할지 숨길지는 Authentication > Password > Enable Forgot Password Link에서 제어할 수 있습니다. 자세한 내용은 구성 문서를 참고하세요.

문제 신고 (Report a Problem)

자체 호스팅 배포에서는 Mattermost 앱의 Help 메뉴에 있는 Report a Problem 옵션의 동작 방식을 다음과 같이 지정할 수 있습니다.

  • Default: Mattermost 라이선스를 보유한 고객은 Mattermost 지원 팀에 이메일로 지원 케이스를 열 수 있습니다. 라이선스가 없는 Mattermost 배포는 문제 해결 포럼으로 안내됩니다.
  • Email address: 사용자가 Mattermost에서 Report a Problem을 선택했을 때 메시지를 보낼 이메일 주소를 입력할 수 있습니다.
  • Custom link: 사용자가 Mattermost에서 Report a Problem을 선택했을 때 이동할 URL을 입력할 수 있습니다.
  • Hide link: Mattermost에서 Report a Problem 옵션을 제거합니다.

이 필드는 채널 헤더 Help 메뉴의 Report a Problem 링크에 사용할 URL을 설정합니다. 이 필드가 비어 있으면 링크가 표시되지 않습니다.

문자열 입력. 기본값은 https://mattermost.com/pl/report-a-bug입니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: SupportSettings > ReportAProblemLink
  • 환경 변수: MM_SUPPORTSETTINGS_REPORTAPROBLEMLINK
참고

이 설정은 자체 호스팅 배포에만 적용됩니다.

문제 신고 이메일 주소 (Report a Problem email address)

이 필드는 채널 헤더 Help 메뉴의 Report a Problem 링크에 사용할 이메일 주소를 설정합니다.

문자열 입력. 비워 둘 수 없습니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: SupportSettings > ReportAProblemMail
  • 환경 변수: MM_SUPPORTSETTINGS_REPORTAPROBLEMMAIL
참고

이 설정은 자체 호스팅 배포에만 적용됩니다.

모바일 앱 로그 다운로드 허용 (Allow mobile app log downloads)

사용자가 문제 해결을 위해 모바일 앱 로그를 다운로드할 수 있도록 합니다. Report a Problem 링크가 표시되면 신고 절차의 일부로 모바일 로그를 다운로드할 수 있습니다.

  • true (기본값): 사용자가 모바일 앱 로그를 다운로드할 수 있습니다.
  • false 사용자가 모바일 앱 로그를 다운로드할 수 없습니다.
  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: SupportSettings > AllowDownloadLogs
  • 환경 변수: MM_SUPPORTSETTINGS_ALLOWDOWNLOADLOGS
참고

이 설정은 자체 호스팅 배포에만 적용됩니다.

이 필드는 Product 메뉴의 Download Apps 링크에 사용할 URL을 설정합니다. 이 필드가 비어 있으면 링크가 표시되지 않습니다.

엔터프라이즈 앱 스토어를 운영한다면 Mattermost 앱에 맞는 다운로드 페이지로 링크를 설정하세요.

문자열 입력. 기본값은 https://mattermost.com/pl/download-apps입니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: NativeAppSettings > AppDownloadLink
  • 환경 변수: MM_NATIVEAPPSETTINGS_APPDOWNLOADLINK
참고

이 설정은 자체 호스팅 배포에만 적용됩니다.

이 필드는 Mattermost Android 앱을 다운로드할 URL을 설정합니다. 모바일 브라우저로 Mattermost 사이트에 접속한 사용자에게 이 링크를 통해 앱을 다운로드하라는 안내가 표시됩니다. 이 필드가 비어 있으면 안내가 표시되지 않습니다.

엔터프라이즈 앱 스토어를 운영한다면 자체 Android 앱으로 연결하세요.

문자열 입력. 기본값은 https://mattermost.com/pl/android-app/입니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: NativeAppSettings > AndroidAppDownloadLink
  • 환경 변수: MM_NATIVEAPPSETTINGS_ANDROIDAPPDOWNLOADLINK
참고

이 설정은 자체 호스팅 배포에만 적용됩니다.

이 필드는 Mattermost iOS 앱을 다운로드할 URL을 설정합니다. 모바일 브라우저로 사이트에 접속한 사용자에게 이 링크를 통해 앱을 다운로드하라는 안내가 표시됩니다. 이 필드가 비어 있으면 안내가 표시되지 않습니다.

엔터프라이즈 앱 스토어를 사용한다면 자체 iOS 앱으로 연결하세요.

문자열 입력. 기본값은 https://mattermost.com/pl/ios-app/입니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: NativeAppSettings > IosAppDownloadLink
  • 환경 변수: MM_NATIVEAPPSETTINGS_IOSAPPDOWNLOADLINK
참고

이 설정은 자체 호스팅 배포에만 적용됩니다.

데스크톱 앱 안내 페이지 활성화 (Enable desktop app landing page)

  • true: (기본값) 사용자에게 데스크톱 앱 사용을 안내합니다.
  • false: 사용자에게 데스크톱 앱 사용을 안내하지 않습니다.
  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: ServiceSettings > EnableDesktopLandingPage > true
  • 환경 변수: MM_SERVICESETTINGS_ENABLEDESKTOPLANDINGPAGE

최소 데스크톱 앱 버전 (Minimum desktop app version)

이 서버에 연결하는 데 필요한 Mattermost 데스크톱 앱의 최소 버전을 지정합니다(예: 5.10.0). 이 최소 버전보다 낮은 데스크톱 앱 버전으로 연결하는 사용자에게는 업데이트 필요 화면이 표시되며, 업데이트 전까지 애플리케이션을 사용할 수 없습니다.

업데이트 화면에는 Mattermost 앱 다운로드 페이지 링크 설정으로 구성한 다운로드 링크가 포함됩니다.

유효한 유의적 버전이어야 합니다(예: 5.0.0). 비워 두면 모든 데스크톱 앱 버전이 연결할 수 있습니다.

문자열 입력. 기본값은 비어 있음(최소 버전 강제 없음)입니다.

  • 시스템 콘솔 경로: Site Configuration > Customization
  • config.json 설정: ServiceSettings > MinimumDesktopAppVersion
  • 환경 변수: MM_SERVICESETTINGS_MINIMUMDESKTOPAPPVERSION

앱 맞춤 URL 스킴 (App custom URL schemes)

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

맞춤 제작된 Mattermost 모바일 앱이 제공하는 리디렉션 링크에 사용할 유효한 맞춤 URL 스킴을 정의합니다. 이를 통해 사용자가 Mattermost 기본 모바일 클라이언트가 아니라 맞춤 제작된 모바일 앱으로 리디렉션됩니다.

이 값을 설정하면 OAuth 또는 SAML 사용자 인증이 완료된 뒤, 모바일 클라이언트가 보낸 맞춤 URL 스킴이 http나 https 같은 기본 스킴을 포함하지 않는지 검증됩니다. 이후 모바일 사용자는 모바일 클라이언트가 제공한 맞춤 스킴 URL을 통해 모바일 앱으로 다시 리디렉션됩니다. 모바일 클라이언트 쪽 값도 유효한 맞춤 URL 스킴으로 함께 갱신할 것을 권장합니다.

이 기능의 config.json 설정은 "NativeAppSettings.AppCustomURLSchemes"이며, 공백으로 구분된 문자열 배열을 입력합니다.

예를 들면 다음과 같습니다.

  • MM_NativeAppSettings_AppCustomURLSchemes = mmauth:// mmauthbeta://
  • mmctl 사용 시: mmctl config set NativeAppSettings.AppCustomURLSchemes "mmauth://" "mmauthbeta://"

모바일 외부 브라우저 (Mobile external browser)

Mattermost v10.2 및 모바일 v2.2.1부터, 이 설정은 모바일 앱이 SSO 인증을 수행할 때 외부 모바일 브라우저를 사용하도록 구성합니다.

  • true: 모바일 앱이 기본 내장 모바일 브라우저로 SSO 인증을 수행합니다.
  • false: (기본값) 모바일 앱이 외부 모바일 브라우저로 SSO 인증을 수행합니다.
  • 시스템 콘솔 경로: N/A
  • config.json 설정: NativeAppSettings.MobileExternalBrowser
  • 환경 변수: MM_NATIVEAPPSETTINGS_MOBILEEXTERNALBROWSER
참고
  • 이 설정은 자체 호스팅 배포에만 적용됩니다.
  • 모바일 앱 SSO 리디렉션 흐름에 문제가 있는 경우 이 구성 설정을 활성화할 것을 권장합니다.

지역화

시스템 콘솔에서 Site Configuration > Localization으로 이동해 다음 구성 설정에 접근합니다. 이 섹션의 구성 설정을 변경하면 적용을 위해 서버를 재시작해야 합니다.

기본 서버 언어 (Default server language)

시스템 메시지와 로그에 사용하는 기본 언어입니다.

옵션: "bg", "de", "en", "en-AU", "es", "fa", "fr", "hu", "it", "ja", "ko", "nl", "pl", "pt-br", "ro", "ru", "sv", "tr", "uk", "vi", "zh-Hans", "zh-Hant".

기본값은 "en"입니다.

  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: LocalizationSettings > DefaultServerLocale
  • 환경 변수: MM_LOCALIZATIONSETTINGS_DEFAULTSERVERLOCALE
참고

이 구성 설정을 변경하면 Settings에서 언어를 지정하지 않은 사용자의 기본 서버 언어가 바뀝니다. 사용자가 언어를 지정한 경우에는 Mattermost가 해당 사용자의 언어 설정을 적용합니다.

기본 클라이언트 언어 (Default client language)

신규 사용자와 로그인하지 않은 상태에서 표시되는 페이지에 사용하는 기본 언어입니다.

옵션: "bg", "de", "en", "en-AU", "es", "fa", "fr", "hu", "it", "ja", "ko", "nl", "pl", "pt-br", "ro", "ru", "sv", "tr", "uk", "vi", "zh-Hans", "zh-Hant".

기본값은 "en"입니다.

  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: LocalizationSettings > DefaultClientLocale
  • 환경 변수: MM_LOCALIZATIONSETTINGS_DEFAULTCLIENTLOCALE
참고

이 구성 설정을 변경하면 Settings에서 언어를 지정하지 않은 사용자의 기본 클라이언트 언어가 바뀝니다. 사용자가 언어를 지정한 경우에는 Mattermost가 해당 사용자의 언어 설정을 적용합니다.

사용 가능한 언어 (Available languages)

사용자가 Settings > Display > Language에서 볼 수 있는 언어 목록을 설정합니다. 이 필드를 비워 두면 사용자에게 지원되는 모든 언어가 표시되며, 새로 지원되는 언어는 자동으로 추가됩니다. 이 필드가 비어 있지 않다면 다른 언어와 함께 Default client language를 반드시 포함해야 합니다. 예를 들어 선택 가능한 언어를 미국 영어와 Español(es)로 제한하려면 문자열을 "en,es"로 지정합니다.

옵션: "bg", "de", "en", "en-AU", "es", "fa", "fr", "hu", "it", "ja", "ko", "nl", "pl", "pt-br", "ro", "ru", "sv", "tr", "uk", "vi", "zh-Hans", "zh-Hant".

기본값은 "en"입니다.

  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: LocalizationSettings > AvailableLocales
  • 환경 변수: MM_LOCALIZATIONSETTINGS_AVAILABLELOCALES

실험적 로케일 활성화 (Enable experimental locales)

번역을 검토하고 번역 누락을 파악할 수 있도록 Mattermost에서 작업 중인 언어를 활성화합니다.

  • true: 공식 지원 언어에 더해 작업 중인 언어도 Mattermost에서 사용할 수 있습니다.
  • false: (기본값) 공식 지원 언어만 Mattermost에서 사용할 수 있습니다.
  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: LocalizationSettings > EnableExperimentalLocales > false
  • 환경 변수: MM_LOCALIZATIONETTINGS_ENABLEEXPERIMENTALLOCALES
참고
  • 클라우드 시스템 관리자는 Mattermost 어카운트 매니저에게 문의해 자신의 인스턴스에서 이 구성 설정을 활성화하도록 요청할 수 있습니다.
  • 작업 중인 언어는 번역이 완전하지 않을 수 있습니다. 번역이 없는 문자열은 미국 영어로 표시됩니다.
  • 현재 이 구성 설정의 영향을 받는 것은 웹과 데스크톱 앱의 제품 문자열뿐입니다. 서버와 모바일 제품 문자열은 이 설정의 영향을 받지 않습니다.
  • Mattermost에서 언어를 선택하는 방법에 대한 자세한 내용은 언어 문서를 참고하세요.

자동 번역

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

시스템 콘솔에서 Site Configuration > Localization으로 이동해 다음 구성 설정에 접근합니다. 이 설정들은 채널 메시지의 자동 번역을 구성합니다. 배포 관련 자세한 내용은 자동 번역 설정 가이드를 참고하세요.

자동 번역 활성화 (Enable auto-translation)

채널 메시지의 자동 번역을 활성화하거나 비활성화합니다.

  • true: 자동 번역을 사용할 수 있으며 채널별로 활성화할 수 있습니다.
  • false: (기본값) 자동 번역이 비활성화됩니다.
  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: AutoTranslationSettings > Enable > false
  • 환경 변수: MM_AUTOTRANSLATIONSETTINGS_ENABLE

번역 공급자 (Translation provider)

자동 번역에 사용할 번역 공급자입니다.

  • libretranslate: 자체 호스팅 LibreTranslate 서버를 번역에 사용합니다.
  • agents: LLM 백엔드를 갖춘 Mattermost Agents 플러그인을 번역에 사용합니다.

기본값은 ""(공급자 미선택)입니다.

  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: AutoTranslationSettings > Provider
  • 환경 변수: MM_AUTOTRANSLATIONSETTINGS_PROVIDER

LibreTranslate URL (LibreTranslate URL)

번역에 사용하는 LibreTranslate 서버의 URL입니다. Mattermost 서버가 이 URL에 접근할 수 있어야 합니다.

문자열 값.

  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: AutoTranslationSettings > LibreTranslate > URL
  • 환경 변수: MM_AUTOTRANSLATIONSETTINGS_LIBRETRANSLATE_URL

LibreTranslate API 키 (LibreTranslate API key)

LibreTranslate 서버에 인증 방식으로 접근하기 위한 API 키입니다. LibreTranslate 서버가 인증을 요구하지 않는다면 비워 두세요.

문자열 값.

  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: AutoTranslationSettings > LibreTranslate > APIKey
  • 환경 변수: MM_AUTOTRANSLATIONSETTINGS_LIBRETRANSLATE_APIKEY

Agents LLM 서비스 ID (Agents LLM service ID)

번역에 사용할, Mattermost Agents 플러그인에 구성된 LLM의 서비스 ID입니다. LLM 서비스는 Agents 플러그인 설정에서 구성합니다.

문자열 값.

  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: AutoTranslationSettings > Agents > LLMServiceID
  • 환경 변수: MM_AUTOTRANSLATIONSETTINGS_AGENTS_LLMSERVICEID

허용 언어 (Languages allowed)

자동 번역이 활성화된 채널의 모든 메시지가 번역될 언어입니다. 채널에 누가 있든 관계없이 모든 메시지가 이 목록의 각 언어로 번역됩니다. 언어는 언어 코드 배열로 지정합니다.

기본값은 ["en"]입니다.

  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: AutoTranslationSettings > TargetLanguages
  • 환경 변수: MM_AUTOTRANSLATIONSETTINGS_TARGETLANGUAGES

번역 제한 시간 (Translation timeout)

번역이 완료되기를 기다리는 최대 시간(밀리초)입니다. 번역이 이 제한 시간을 초과하면 건너뜁니다.

숫자 값. 기본값은 5000(5초)입니다.

  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: AutoTranslationSettings > TimeoutMs > 5000
  • 환경 변수: MM_AUTOTRANSLATIONSETTINGS_TIMEOUTMS

다이렉트 메시지 및 그룹 메시지에서 자동 번역 제한 (Restrict autotranslation in direct and group messages)

다이렉트 메시지와 그룹 메시지에서 자동 번역을 활성화하지 못하도록 제한합니다.

  • true: 다이렉트 메시지나 그룹 메시지에서 자동 번역을 활성화할 수 없습니다.
  • false: (기본값) 다이렉트 메시지와 그룹 메시지에서 자동 번역을 활성화할 수 있습니다.
  • 시스템 콘솔 경로: Site Configuration > Localization
  • config.json 설정: AutoTranslationSettings > RestrictDMAndGM > false
  • 환경 변수: MM_AUTOTRANSLATIONSETTINGS_RESTRICTDMANDGM

번역 워커 (Translation workers)

노드당 동시 번역 워커 수입니다. 값이 클수록 번역 처리량이 늘어나지만 자원을 더 많이 사용합니다. 이 설정은 시스템 콘솔에서 제공되지 않으며 mmctl, config.json, 환경 변수로만 설정할 수 있습니다.

숫자 값. 기본값은 6입니다.

  • config.json 설정: AutoTranslationSettings > Workers > 6
  • 환경 변수: MM_AUTOTRANSLATIONSETTINGS_WORKERS

사용자 및 팀

시스템 콘솔에서 Site Configuration > Users and Teams로 이동해 다음 구성 설정에 접근합니다.

팀당 최대 사용자 수 (Max users per team)

Max users per team은 활성화된 사용자와 비활성화된 사용자를 모두 포함한 팀당 최대 사용자 수입니다.

Mattermost에서 팀은 구체적인 목표를 가진 소규모 조직이어야 합니다. 현실 세계로 치면 하나의 테이블에 둘러앉을 수 있는 정도의 규모입니다. 기본 최댓값(50)이면 대부분의 팀에 충분하지만, 적절한 하드웨어를 갖추면 이 한도를 수천 명까지 늘릴 수 있습니다.

채널은 팀 내에서 주제별로 커뮤니케이션을 정리하는 또 다른 방법입니다.

숫자 입력. 기본값은 자체 호스팅 배포에서 50, 클라우드 배포에서 10000입니다.

  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: TeamSettings > MaxUsersPerTeam > 50
  • 환경 변수: MM_TEAMSETTINGS_MAXUSERSPERTEAM

팀당 최대 채널 수 (Max channels per team)

활성 채널과 보관된 채널을 모두 포함한 팀당 최대 채널 수입니다.

숫자 입력. 기본값은 자체 호스팅 배포에서 2000, 클라우드 배포에서 10000입니다.

  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: TeamSettings > MaxChannelsPerTeam > 2000
  • 환경 변수: MM_TEAMSETTINGS_MAXCHANNELSPERTEAM

입장/퇴장 메시지 기본 활성화 (Enable join/leave messages by default)

사용자가 채널에 입장하거나 퇴장할 때 표시되는 시스템 메시지의 기본 구성을 지정합니다.

  • true: (기본값) 입장/퇴장 메시지가 표시됩니다.
  • false: 입장/퇴장 메시지가 숨겨집니다.

사용자는 Settings > Advanced > Enable Join/Leave Messages에서 이 기본값을 개별적으로 변경할 수 있습니다.

  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: TeamSettings > EnableJoinLeaveMessageByDefault > true
  • 환경 변수: MM_TEAMSETTINGS_ENABLEJOINLEAVEMESSAGEBYDEFAULT

다이렉트 메시지 채널을 열 수 있는 대상 (Enable users to open direct message channels with)

이 설정은 사용자가 Mattermost 서버의 누구와도 다이렉트 메시지 채널을 열 수 있는지, 아니면 같은 팀 구성원과만 열 수 있는지를 결정합니다. 이 설정은 사용자 인터페이스에 표시되는 선택지에만 영향을 주며, 백엔드 서버의 권한에는 영향을 주지 않습니다.

  • Any user on the Mattermost server: (기본값) 사용자는 Direct Messages > More 메뉴를 통해 모든 사용자에게 다이렉트 메시지를 보낼 수 있습니다. config.json 설정: "any"
  • Any member of the team: Direct Messages > More 메뉴에서 같은 팀의 사용자에게만 다이렉트 메시지를 보낼 수 있습니다. Windows나 Linux에서 Ctrl K, Mac에서 ⌘ K를 누르면 현재 보고 있는 팀의 다른 사용자만 표시됩니다. 여러 팀에 속한 사용자는 현재 보고 있는 팀에만 다이렉트 메시지를 보낼 수 있습니다. 다만 현재 보고 있는 팀과 관계없이 다른 팀에서 오는 메시지는 받을 수 있습니다. config.json 설정: "team"
  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: TeamSettings > RestrictDirectMessage
  • 환경 변수: MM_TEAMSETTINGS_RESTRICTDIRECTMESSAGE

팀원 이름 표시 방식 (Teammate name display)

이 설정은 게시물과 Direct Messages 목록에 이름이 어떻게 표시되는지를 결정합니다. 시스템 관리자가 Lock teammate name display for all users 구성 설정으로 잠그지 않는 한, 사용자는 Settings > Display > Teammate Name Display에서 이 설정을 변경할 수 있습니다.

  • Show username: (자체 호스팅 배포 기본값) 사용자 이름(username)을 표시합니다. config.json 옵션: "username".
  • Show nickname if one exists...: 사용자의 닉네임을 표시합니다. 닉네임이 없으면 전체 이름을 표시하고, 전체 이름도 없으면 사용자 이름을 표시합니다. config.json 옵션: "nickname_full_name".
  • Show first and last name: (클라우드 배포 기본값) 사용자의 전체 이름을 표시합니다. 전체 이름이 없으면 사용자 이름을 표시합니다. SAML이나 LDAP을 사용하면서 이름과 성 속성을 구성한 경우에 권장합니다. config.json 옵션: "full_name".
  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: TeamSettings > TeammateNameDisplay > username
  • 환경 변수: MM_TEAMSETTINGS_TEAMMATENAMEDISPLAY

모든 사용자에 대해 팀원 이름 표시 방식 잠금 (Lock teammate name display for all users)

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

이 설정은 사용자가 Settings > Display > Teammate Name Display의 설정을 변경할 수 있는지를 제어합니다.

  • true: 사용자가 팀원 이름 표시 방식을 변경할 수 없습니다.
  • false: (기본값) 사용자가 팀원 이름 표시 방식 설정을 변경할 수 있습니다.
  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: TeamSettings > LockTeammateNameDisplay > false
  • 환경 변수: MM_TEAMSETTINGS_LOCKTEAMMATENAMEDISPLAY

보관된 채널 열람 허용 (Allow users to view archived channels)

  • true: (기본값) 사용자가 자신이 구성원이었던 보관 채널의 콘텐츠에 접근할 수 있습니다.
  • false: 사용자가 보관된 채널의 콘텐츠에 접근할 수 없습니다.
  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: TeamSettings > ExperimentalViewArchivedChannels > true
  • 환경 변수: MM_TEAMSETTINGS_EXPERIMENTALVIEWARCHIVEDCHANNELS
참고
  • Mattermost v11부터 이 구성 설정은 항상 활성화되어 있으며 더 이상 구성할 수 없습니다. 사용자는 자신이 구성원인 보관 채널에 언제든지 접근할 수 있습니다.
  • 클라우드 관리자는 이 구성 설정을 변경할 수 없습니다.

이메일 주소 표시 (Show email address)

  • true: (기본값) 모든 사용자가 다른 모든 사용자의 이메일 주소를 볼 수 있습니다.
  • false: 시스템 관리자와 컴플라이언스, 청구, 사용자 관리(사용자/팀/채널/그룹 등)에 읽기·쓰기 권한을 가진 시스템 역할을 제외하고 클라이언트 사용자 인터페이스에서 이메일 주소를 숨깁니다.
  • 시스템 콘솔 경로: Site Configuration > Users and teams
  • config.json 설정: PrivacySettings > ShowEmailAddress > true
  • 환경 변수: MM_PRIVACYSETTINGS_SHOWEMAILADDRESS

전체 이름 표시 (Show full name)

  • true: (기본값) 클라이언트 사용자 인터페이스에서 모든 사용자에게 전체 이름이 표시됩니다.
  • false: 시스템 관리자를 제외한 모든 사용자에게 전체 이름을 숨깁니다. 전체 이름 대신 사용자 이름이 표시됩니다.
  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: PrivacySettings > ShowFullName > true
  • 환경 변수: MM_PRIVACYSETTINGS_SHOWFULLNAME

익명 팀·채널 URL 활성화 (Enable anonymous team and channel URLs)

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

Mattermost v11.6.0부터, 이 설정을 활성화하면 팀과 채널 URL이 익명화되어 URL에 팀 이름이나 채널 이름이 포함되지 않습니다. 이를 통해 웹 주소를 통해 팀과 채널 이름이 식별되는 것을 방지합니다.

이 설정을 활성화하면 팀과 채널 생성 워크플로에서 사용자가 URL을 정의하는 단계가 사라지고, 자동 생성된 익명 URL로 팀과 채널이 만들어집니다. 이는 새로 생성되는 팀과 채널에만 적용되며 기존 팀과 채널에는 영향을 주지 않습니다.

  • true: 팀과 채널 URL이 익명화됩니다.
  • false: 팀과 채널 URL에 팀 이름 또는 채널 이름이 포함됩니다.
  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: PrivacySettings > UseAnonymousURLs
  • 환경 변수: MM_PRIVACYSETTINGS_USEANONYMOUSURLS

맞춤 사용자 상태 활성화 (Enable custom user statuses)

  • true: (기본값) 사용자가 모든 사용자에게 보이는 상태 메시지와 이모지를 설정할 수 있습니다.
  • false: 사용자가 맞춤 상태를 설정할 수 없습니다.
  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: TeamSettings > EnableCustomUserStatuses > true
  • 환경 변수: MM_TEAMSETTINGS_ENABLECUSTOMUSERSTATUSES

마지막 활동 시각 표시 활성화 (Enable last active time)

  • true: (기본값) 사용자가 프로필과 다이렉트 메시지 채널 헤더에서 비활성화된 사용자의 마지막 활동 시각을 볼 수 있습니다.
  • false: 사용자가 비활성화된 사용자의 마지막 접속 시각을 볼 수 없습니다.
  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: TeamSettings > EnableLastActiveTime > true
  • 환경 변수: MM_TEAMSETTINGS_ENABLELASTACTIVETIME

맞춤 사용자 그룹 활성화 (Enable custom user groups)

  • true: (기본값) 적절한 권한을 가진 사용자가 맞춤 사용자 그룹을 만들 수 있으며, 사용자는 Mattermost 대화에서 맞춤 사용자 그룹을 @멘션할 수 있습니다.
  • false: 맞춤 사용자 그룹을 만들 수 없습니다.
  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: ServiceSettings > EnableCustomGroups > true
  • 환경 변수: MM_SERVICESETTINGS_ENABLECUSTOMGROUPS

사용자 통계 갱신 시각 (User statistics update time)

각 사용자의 전체 메시지 수와 가장 최근에 보낸 메시지의 타임스탬프를 포함한 사용자 게시물 통계를 갱신할 서버 시각을 설정합니다.

서버 로컬 시간을 기준으로 HH:MM 형식의 24시간제 타임스탬프여야 합니다. 기본값은 00:00입니다.

  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: ServiceSettings > RefreshPostStatsRunTime > 00:00
  • 환경 변수: MM_SERVICESETTINGS_REFRESHPOSTSTATSRUNTIME

채널 카테고리 정렬 (Channel category sorting)

Mattermost v11.8부터 채널 카테고리 정렬이 기본으로 활성화됩니다. 활성화하면 채널 관리자가 채널을 만들거나 편집할 때 기본 사이드바 카테고리를 선택할 수 있습니다. 채널 관리자는 기존 카테고리를 선택하거나, 새 카테고리 이름을 입력하거나, 채널 설정에서 기본 카테고리를 지울 수 있습니다. 채널에 참여한 구성원에게는 해당 채널이 사이드바의 그 카테고리 아래에 표시됩니다. 비활성화하면 기본 카테고리 선택기가 숨겨집니다.

  • true: (기본값) 지원되는 채널을 만들거나 편집할 때 채널 관리자에게 Default category (optional) 필드가 표시됩니다. 기존 카테고리를 선택하거나, 새 카테고리 이름을 입력하거나, 채널 설정에서 기본 카테고리를 지울 수 있습니다. 채널에 참여한 구성원에게는 해당 채널이 사이드바의 그 카테고리 아래에 표시됩니다.
  • false: 채널을 만들거나 편집할 때 기본 카테고리 선택기가 숨겨집니다.
  • 시스템 콘솔 경로: Site Configuration > Users and Teams
  • config.json 설정: TeamSettings > EnableChannelCategorySorting > true
  • 환경 변수: MM_TEAMSETTINGS_ENABLECHANNELCATEGORYSORTING

알림

시스템 콘솔에서 Site Configuration > Notifications로 이동해 다음 구성 설정에 접근합니다.

@channel, @all, @here 확인 대화상자 표시 (Show @channel, @all, or @here confirmation dialog)

  • true: (기본값) 구성원이 5명을 초과하는 채널에서 @channel, @all, @here 또는 그룹 멘션을 게시할 때 사용자에게 확인을 요구합니다.
  • false: 확인이 필요하지 않습니다.
  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: TeamSettings > EnableConfirmNotificationsToChannel > true
  • 환경 변수: MM_TEAMSETTINGS_ENABLECONFIRMNOTIFICATIONSTOCHANNEL

이메일 알림 활성화 (Enable email notifications)

  • true: (기본값) 게시물에 대한 자동 이메일 알림을 활성화합니다.
  • false: 알림을 비활성화합니다. 개발자는 이메일 설정을 건너뛰어 개발 속도를 높이기 위해 이 옵션을 선택할 수 있습니다(Enable preview mode banner 설정도 참고하세요).
  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: EmailSettings > SendEmailNotifications > ture
  • 환경 변수: MM_EMAILSETTINGS_SENDEMAILNOTIFICATIONS
참고
  • 클라우드 관리자는 이 구성 설정을 변경할 수 없습니다.
  • 이 설정이 false이더라도 SMTP 서버가 구성되어 있으면 인증 메시지 같은 계정 관련 이메일은 이 설정과 무관하게 발송됩니다.
  • 이메일 초대와 계정 비활성화 이메일은 이 설정의 영향을 받지 않습니다.
  • Mattermost의 이메일 구성을 계획하고 있지 않다면, 대규모 배포에서 이 구성 설정을 비활성화하는 것이 다음 영역에서 서버 성능을 개선할 수 있습니다. 특히 성능이 중요한 고트래픽 환경에서 그렇습니다.
    • 서버 부하 감소: 이메일을 생성하고 발송하려면 처리 능력과 자원이 필요합니다. 이메일 알림을 비활성화하면 서버 부하가 줄어들고, 그만큼의 자원을 다른 작업에 재배치할 수 있습니다.
    • I/O 작업 감소: 이메일 발송에는 로그와 데이터베이스 쓰기, 이메일 서버와의 통신 처리 같은 입출력(I/O) 작업이 수반됩니다. 이러한 I/O 작업을 줄이면 시스템 전체 효율이 개선될 수 있습니다.
    • 네트워크 트래픽 감소: 발송되는 이메일 하나하나가 네트워크 트래픽을 유발합니다. 이메일 알림을 비활성화하면 전송되는 데이터양이 줄어들어, 특히 대역폭이 제한된 환경에서 성능이 개선될 수 있습니다.
    • 응답 시간 단축: 이메일 발송 같은 백그라운드 작업이 줄어들면 애플리케이션이 사용자 요청에 더 빠르게 응답할 수 있어 체감 성능이 개선될 수 있습니다.
    • 자원 배분: 이메일 발송에 사용되었을 CPU 사이클, 메모리, 네트워크 대역폭 같은 자원을 다른 곳에 사용할 수 있어 시스템의 다른 핵심 구성 요소의 성능이 개선될 수 있습니다.
    • 다만 이메일 알림을 비활성화하면 사용자 경험, 커뮤니케이션 효율, 전반적인 생산성에 부정적인 영향을 줄 수 있습니다. 성능 개선과 조직 및 사용자의 필요 사이에서 균형을 잡는 것이 중요합니다.

미리보기 모드 배너 활성화 (Enable preview mode banner)

  • true: (기본값) Send email notifications가 false일 때 사용자에게 Preview Mode 배너가 표시됩니다. 이 배너는 이메일 알림이 비활성화되어 있음을 사용자에게 알립니다.
  • false: Preview Mode 배너가 표시되지 않습니다.
  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: EmailSettings > EnablePreviewModeBanner > true
  • 환경 변수: MM_EMAILSETTINGS_ENABLEPREVIEWMODEBANNER
참고

클라우드 관리자는 이 구성 설정을 변경할 수 없습니다.

이메일 일괄 발송 활성화 (Enable email batching)

  • true: 일정 기간 동안 발생한 멘션과 다이렉트 메시지에 대한 여러 이메일 알림이 하나의 이메일로 묶여 발송됩니다.
  • false: (기본값) 멘션이나 다이렉트 메시지마다 이메일 알림이 발송됩니다.
  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: EmailSettings > EnableEmailBatching > false
  • 환경 변수: MM_EMAILSETTINGS_ENABLEEMAILBATCHING
참고

이메일 알림 내용 (Email notification contents)

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

  • Send full message contents: (기본값) 이메일 알림에 보낸 사람과 채널 이름은 물론 메시지 전문이 포함됩니다. config.json 설정: "full"
  • Send generic description with only sender name: 이메일 알림에 보낸 사람 이름과 팀 이름만 포함됩니다. Mattermost에 기밀 정보가 있고 정책상 이를 이메일에 저장할 수 없는 경우 이 옵션을 사용하세요. config.json 설정: "generic"
  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: EmailSettings > EmailNotificationContentsType
  • 환경 변수: MM_EMAILSETTINGS_EMAILNOTIFICATIONCONTENTSTYPE

알림 표시 이름 (Notification display name)

Mattermost 시스템에서 발송하는 이메일 알림에 사용할 표시 이름입니다.

문자열 입력. 기본값이 없습니다. 시스템 콘솔에서 설정을 변경할 때 이 필드는 필수입니다.

  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: EmailSettings > FeedbackName
  • 환경 변수: MM_EMAILSETTINGS_FEEDBACKNAME

알림 발신 주소 (Notification from address)

Mattermost 시스템에서 발송하는 알림 이메일의 발신 이메일 주소입니다. 이 주소는 시스템 관리자가 관리해야 합니다.

문자열 입력. 기본값은 test@example.com입니다. 시스템 콘솔에서 설정을 변경할 때 이 필드는 필수입니다.

  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: EmailSettings > FeedbackEmail
  • 환경 변수: MM_EMAILSETTINGS_FEEDBACKEMAIL
참고

클라우드 관리자는 이 구성 설정을 변경할 수 없습니다.

지원 이메일 주소 (Support email address)

이메일 알림과 시작하기 튜토리얼에 표시되는 사용자 지원(또는 피드백) 이메일 주소를 설정합니다. 이 주소는 시스템 관리자가 관리해야 합니다. 값을 설정하지 않으면 이메일 알림에 사용자가 도움을 요청할 수 있는 수단이 포함되지 않습니다.

문자열 입력. 기본값은 feedback@mattermost.com입니다. 시스템 콘솔에서 설정을 변경할 때 이 필드는 필수입니다.

  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: SupportSettings > SupportEmail
  • 환경 변수: MM_SUPPORTSETTINGS_SUPPORTEMAIL

알림 회신 주소 (Notification reply-to address)

Mattermost 시스템에서 알림 이메일을 발송할 때 reply-to 헤더에 사용하는 이메일 주소입니다. 이 주소는 시스템 관리자가 관리해야 합니다.

문자열 입력. 기본값은 test@example.com입니다.

  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: EmailSettings > ReplyToAddress
  • 환경 변수: MM_EMAILSETTINGS_REPLYTOADDRESS

이메일 알림 푸터에 조직 이름과 우편 주소를 포함하는 선택 설정입니다. 설정하지 않으면 아무것도 표시되지 않습니다.

문자열 입력.

  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: EmailSettings > FeedbackOrganization
  • 환경 변수: MM_EMAILSETTINGS_FEEDBACKORGANIZATION

푸시 알림 내용 (Push notification contents)

  • Generic description with only sender name: 푸시 알림에 보낸 사람 이름만 포함되고 채널 이름이나 메시지 내용은 포함되지 않습니다. config.json 설정: "generic_no_channel"
  • Generic description with sender and channel names: (기본값) 푸시 알림에 보낸 사람과 채널 이름이 포함되지만 메시지 내용은 포함되지 않습니다. config.json 설정: "generic"
  • Full message content sent in the notification payload: 푸시 알림 페이로드에 메시지 내용을 포함합니다. 이 페이로드는 Apple Push Notification service 또는 Google Firebase Cloud Messaging을 통해 전송될 수 있습니다. 연결을 암호화하고 기밀 정보를 보호할 수 있도록 이 옵션은 https 프로토콜과 함께 사용할 것을 강력히 권장합니다. config.json 설정: "full"
  • Full message content fetched from the server on receipt (Mattermost Enterprise에서 사용 가능): 알림 페이로드에는 메시지 내용이 담기지 않습니다. 대신 고유한 메시지 ID가 담기며, iOS의 notification service app extension이나 Android의 확장형 알림 패턴을 통해 푸시 알림을 받을 때 이 ID로 Mattermost 서버에서 메시지 내용을 가져옵니다.

    서버에 연결할 수 없으면 메시지 내용이나 보낸 사람 이름 없이 일반 푸시 알림이 표시됩니다. Mattermost 모바일 애플리케이션을 보안 컨테이너로 감싸는 고객의 경우, 푸시 알림을 받았을 때 컨테이너가 고유 메시지 ID로 메시지 내용을 가져와야 합니다.

    컨테이너가 이 가져오기를 실행할 수 없으면, Apple이나 Google의 알림 서비스를 통해 메시지 내용을 전달하지 않는 한 고객의 모바일 애플리케이션은 푸시 알림 내용을 받을 수 없습니다. config.json 설정: "id_loaded"

  • 시스템 콘솔 경로: Site Configuration > Notifications
  • config.json 설정: EmailSettings > PushNotificationContents
  • 환경 변수: MM_EMAILSETTINGS_PUSHNOTIFICATIONCONTENTS

알림 모니터링 활성화 (Enable notification monitoring)

알림 메트릭 데이터 수집을 활성화하거나 비활성화합니다.

  • true: (기본값) 클라이언트 측 웹 및 데스크톱 앱 사용자에 대해 Mattermost 알림 데이터 수집이 활성화됩니다.
  • false: Mattermost 알림 데이터 수집이 비활성화됩니다.
  • 시스템 콘솔 경로: Environment > Performance Monitoring
  • config.json 설정: MetricsSettings > EnableNotificationMetrics > true
  • 환경 변수: MM_METRICSSETTINGS_ENABLENOTIFICATIONMETRICS
참고

Mattermost 알림 상태(Notification Health) 메트릭에 대한 자세한 내용은 성능 모니터링 문서를 참고하세요.

시스템 전체 알림

시스템 콘솔에서 Site Configuration > System-wide notifications로 이동해 다음 구성 설정에 접근합니다.

시스템 전체 알림 활성화 (Enable system-wide notifications)

  • true: 모든 팀의 모든 사용자에게 Mattermost 인터페이스 상단에 시스템 전체 알림을 표시합니다.
  • false: (기본값) 시스템 전체 알림을 비활성화합니다.
  • 시스템 콘솔 경로: Site Configuration > System-wide notifications
  • config.json 설정: AnnouncementSettings > SystemWideNotifications > false
  • 환경 변수: MM_ANNOUNCEMENTSETTINGS_SYSTEMWIDENOTIFICATIONS

시스템 전체 알림이 활성화되어 있을 때 표시할 텍스트입니다.

문자열 입력.

  • 시스템 콘솔 경로: Site Configuration > System-wide notifications
  • config.json 설정: AnnouncementSettings > BannerText
  • 환경 변수: MM_ANNOUNCEMENTSETTINGS_BANNERTEXT

시스템 전체 알림의 배경 색상입니다.

CSS 색상 값을 문자열로 입력합니다.

  • 시스템 콘솔 경로: Site Configuration > System-wide notifications
  • config.json 설정: AnnouncementSettings > BannerColor > "#f2a93b"
  • 환경 변수: MM_ANNOUNCEMENTSETTINGS_BANNERCOLOR

시스템 전체 알림의 텍스트 색상입니다.

CSS 색상 값을 문자열로 입력합니다.

  • 시스템 콘솔 경로: Site Configuration > System-wide notifications
  • config.json 설정: AnnouncementSettings > BannerTextColor > "#333333"
  • 환경 변수: MM_ANNOUNCEMENTSETTINGS_BANNERTEXTCOLOR

배너 닫기 허용 (Allow banner dismissal)

  • true: (기본값) 사용자가 시스템 전체 알림을 닫을 수 있습니다. 다음에 로그인할 때, 관리자가 텍스트를 변경했을 때, 관리자가 시스템 전체 알림을 껐다가 다시 켰을 때 알림이 다시 표시됩니다.
  • false: 사용자가 배너를 닫을 수 없습니다.
  • 시스템 콘솔 경로: Site Configuration > System-wide notifications
  • config.json 설정: AnnouncementSettings > AllowBannerDismissal > true
  • 환경 변수: MM_ANNOUNCEMENTSETTINGS_ALLOWBANNERDISMISSAL

이모지

시스템 콘솔에서 Site Configuration > Emoji로 이동해 다음 구성 설정에 접근합니다.

이모지 선택기 활성화 (Enable emoji picker)

  • true: (기본값) 메시지를 작성할 때와 메시지 반응에 이모지 선택기를 사용할 수 있습니다.
  • false: 메시지 작성과 반응에서 이모지 선택기를 사용할 수 없습니다.
  • 시스템 콘솔 경로: Site Configuration > Emoji
  • config.json 설정: ServiceSettings > EnableEmojiPicker > true
  • 환경 변수: MM_SERVICESETTINGS_ENABLEEMOJIPICKER

맞춤 이모지 활성화 (Enable custom emoji)

  • true: (기본값) 사용자가 이모지 선택기의 Custom Emoji 옵션을 통해 최대 6000개의 이모지를 추가할 수 있습니다. 이모지는 512KB 이하의 GIF, PNG, JPG 파일이어야 합니다.
  • false: 맞춤 이모지를 사용할 수 없습니다.
  • 시스템 콘솔 경로: Site Configuration > Emoji
  • config.json 설정: ServiceSettings > EnableCustomEmoji > true
  • 환경 변수: MM_SERVICESETTINGS_ENABLECUSTOMEMOJI
참고

Mattermost는 최대 6000개의 맞춤 이모지를 지원하지만, 맞춤 이모지가 늘어나면 서버 성능이 저하될 수 있습니다.

게시물

시스템 콘솔에서 Site Configuration > Posts로 이동해 다음 구성 설정에 접근합니다.

스레드 자동 팔로우 (Automatically follow threads)

  • true: (기본값) 사용자가 시작했거나, 참여했거나, 멘션된 모든 스레드를 자동으로 팔로우합니다. 데이터베이스의 Threads 테이블이 스레드와 스레드 참여자를 추적합니다. ThreadMembership 테이블은 사용자별로 팔로우 중인 스레드와 해당 스레드의 읽음 여부를 추적합니다.
  • false: 스레드 자동 팔로우를 비활성화합니다.
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > ThreadAutoFollow > true
  • 환경 변수: MM_SERVICESETTINGS_THREADAUTOFOLLOW
참고
  • 이 설정은 자체 호스팅 배포에만 적용됩니다.
  • 스레드 대화가 동작하려면 이 설정이 반드시 활성화되어 있어야 합니다.
  • 이 설정을 활성화하더라도 이전 사용자 활동을 근거로 스레드를 자동 팔로우하지는 않습니다. 예를 들어 사용자가 이 설정을 켜기 전에 참여했던 스레드는, 새 댓글을 달거나 해당 스레드에서 멘션되지 않는 한 자동으로 팔로우되지 않습니다.

스레드 대화 (Threaded discussions)

중요

v7.0 이전의 레거시 Mattermost 릴리스에서 업그레이드하는 고객은 이 기능을 활성화하기 전에 스레드 대화 활성화 관리자 가이드(이전 명칭 Collapsed Reply Threads)를 반드시 검토해야 합니다.

  • Always On: (기본값) 서버와 모든 사용자에 대해 스레드 대화를 활성화합니다. 최적의 사용자 경험과, 사용자가 스레드 대화를 읽고 답하는 방식의 일관성을 위해 권장하는 구성입니다. config.json 설정: "always_on"
  • Default On: 서버와 모든 사용자에 대해 스레드 대화를 활성화합니다.
  • Default Off: 서버에서는 스레드 대화를 활성화하지만 사용자에게는 활성화하지 않습니다.
  • Disabled: 사용자가 스레드 대화를 활성화할 수 없습니다. config.json 설정: "disabled"
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > CollapsedThreads
  • 환경 변수: MM_SERVICESETTINGS_COLLAPSEDTHREADS

메시지 우선순위 (Message priority)

팁

Mattermost Enterprise 또는 Professional 고객은 추가로 메시지 확인 응답을 요청해, 시간에 민감한 특정 메시지를 상대가 확인하고 조치했는지 추적할 수 있습니다. 자세한 내용은 메시지 우선순위 문서를 참고하세요.

  • true: (기본값) 모든 사용자에게 메시지 우선순위를 활성화하여, 중요하거나 긴급한 최상위 메시지에 시각적 표시를 지정할 수 있게 합니다.
  • false: 메시지 우선순위 지정과 확인 응답 요청 기능을 비활성화합니다.
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > PostPriority > true
  • 환경 변수: MM_SERVICESETTINGS_POSTPRIORITY
참고

대규모 배포에서 이 구성 설정을 비활성화하면 다음 영역에서 서버 성능이 개선될 수 있습니다. 특히 성능과 응답성이 중요한 환경에서 그렇습니다.

  • 처리 단순화: 게시물 우선순위가 활성화되면 시스템은 지정된 우선순위 수준에 따라 게시물을 관리하고 정렬해야 합니다. 시스템이 게시물을 평가하고 그에 맞게 정렬해야 하므로 처리 부담이 추가됩니다. 이 기능을 비활성화하면 모든 게시물이 동일하게 처리되어 처리 로직이 단순해지고 연산 부하가 줄어듭니다.
  • 지연 감소: 게시물 우선순위가 활성화되어 있으면 시스템이 각 게시물의 우선순위를 판단하고 올바른 순서로 처리하는 동안 지연이 발생할 수 있습니다. 게시물 우선순위를 비활성화하면 시스템이 선입선출 방식으로 게시물을 처리하므로 처리 방식이 더 일관되고 빨라질 수 있습니다.
  • 자원 사용량 감소: 게시물 우선순위 관리는 CPU와 메모리 같은 시스템 자원을 추가로 소비합니다. 이 기능을 비활성화하면 해당 자원이 확보되어 시스템이 다른 작업에 배분할 수 있고, 전체 성능이 개선됩니다.
  • 확장성 개선: 고트래픽 환경에서는 게시물 우선순위 관리의 복잡성이 더 두드러집니다. 이 기능을 비활성화하면 시스템 동작이 단순해져 사용자와 게시물이 늘어나도 확장하기 쉬워집니다.

지속 알림 (Persistent notifications)

  • true: (기본값) 사용자가 긴급 메시지에서 멘션된 수신자에게 반복 알림을 보낼 수 있습니다.
  • false: 반복 알림 발송 기능을 비활성화합니다.
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > AllowPersistentNotifications > true
  • 환경 변수: MM_SERVICESETTINGS_ALLOWPERSISTENTNOTIFICATIONS

지속 알림 최대 수신자 수 (Maximum number of recipients for persistent notifications)

사용자가 지속 알림을 보낼 수 있는 최대 수신자 수입니다.

숫자 입력. 기본값은 5입니다.

  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > PersistentNotificationMaxRecipients > 5
  • 환경 변수: MM_SERVICESETTINGS_PERSISTENTNOTIFICATIONMAXRECIPIENTS

지속 알림 주기 (Frequency of persistent notifications)

지속 알림으로 보낸 긴급 메시지의 반복 알림 간격(분)입니다.

숫자 입력. 기본값은 5이고 최솟값은 2입니다.

  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > PersistentNotificationIntervalMinutes > 5
  • 환경 변수: MM_SERVICESETTINGS_PERSISTENTNOTIFICATIONINTERVALMINUTES

게시물당 지속 알림 총 횟수 (Total number of persistent notifications per post)

사용자가 지속 알림을 받을 수 있는 최대 횟수입니다.

숫자 입력. 기본값은 6입니다.

  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > PersistentNotificationMaxCount > 6
  • 환경 변수: MM_SERVICESETTINGS_PERSISTENTNOTIFICATIONMAXCOUNT

읽으면 소멸하는 메시지 활성화 (Enable burn-on-read messages)

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

읽으면 소멸하는 메시지는 되돌릴 수 없는 동작을 합니다.

  • 수신자가 읽으면 소멸하는 메시지를 한 번 열어 보면 다시 숨길 수 없습니다.
  • 읽으면 소멸하는 메시지는 만료되거나 소멸하면 영구히 삭제되며 복구할 수 없습니다.
  • 수신자는 읽으면 소멸하는 메시지에 답글을 달거나, 편집하거나, 스레드를 만들 수 없습니다.

읽으면 소멸하는 메시지를 활성화하거나 비활성화합니다.

  • false: (기본값) 읽으면 소멸하는 메시지를 보내는 옵션이 제공되지 않습니다.
  • true: 사용자가 채널, 다이렉트 메시지, 그룹 메시지에서 읽으면 소멸하는 메시지를 보낼 수 있습니다.
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > EnableBurnOnRead > false
  • 환경 변수: MM_SERVICESETTINGS_ENABLEBURNONREAD
참고

이 기능을 비활성화하면 사용자가 새로운 읽으면 소멸하는 메시지를 보낼 수 없습니다. 비활성화한 뒤에도 기존의 읽으면 소멸하는 메시지에는 계속 접근할 수 있습니다.

읽으면 소멸하는 메시지 지속 시간 (Burn-on-read duration)

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

읽으면 소멸하는 메시지가 열린 뒤의 카운트다운 시간을 설정합니다. 수신자가 메시지를 열면 지정한 시간이 지난 후 해당 사용자에게서 메시지가 삭제됩니다. 이 설정은 모든 읽으면 소멸하는 메시지에 적용됩니다.

숫자 입력(초). 기본값은 600초(10분)입니다.

  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > BurnOnReadDurationSeconds > 600
  • 환경 변수: MM_SERVICESETTINGS_BURNONREADDURATIONSECONDS

읽으면 소멸하는 메시지 최대 유지 시간 (Maximum time to live for burn-on-read messages)

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

읽으면 소멸하는 메시지가 발송된 뒤 존재할 수 있는 최대 시간을 설정합니다. 모든 수신자가 열어 보지 않았더라도 지정한 시간이 지나면 메시지가 삭제됩니다.

숫자 입력(초). 기본값은 604800초(7일)입니다.

  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > BurnOnReadMaximumTimeToLiveSeconds > 604800
  • 환경 변수: MM_SERVICESETTINGS_BURNONREADMAXIMUMTIMETOLIVESECONDS
중요

미리보기를 생성하려면 서버가 인터넷에 연결되어 있어야 합니다. 필요하다면 방화벽이나 아웃바운드 프록시를 통해 이 연결을 구성할 수 있습니다.

  • true: 서버가 메시지에 링크된 첫 번째 웹사이트, 이미지, YouTube 동영상의 미리보기를 생성합니다. 사용자는 Settings > Display > Website Link Previews에서 웹사이트 미리보기를 끌 수 있지만, 이미지나 YouTube 미리보기는 끌 수 없습니다.
  • false: (기본값) 모든 미리보기가 비활성화되며, 서버는 메시지에 포함된 어떤 링크에 대해서도 메타데이터를 요청하지 않습니다.
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > EnableLinkPreviews > true
  • 환경 변수: MM_SERVICESETTINGS_ENABLELINKPREVIEWS
참고

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

  • 네트워크 요청 감소: 링크 미리보기가 활성화되어 있으면 시스템이 링크된 웹페이지에서 제목, 설명, 이미지 같은 메타데이터를 가져와야 합니다. 이는 추가 네트워크 요청을 유발해 시스템을 느리게 만들 수 있습니다.
  • 서버 부하 감소: 링크 미리보기를 만들려면 링크된 페이지의 콘텐츠를 파싱해야 합니다. 많은 사용자가 링크를 공유하면 서버는 수많은 네트워크 요청을 수행하고 상당한 양의 추가 데이터를 처리해야 하므로 부하가 커집니다.
  • 데이터 처리 감소: 공유되는 모든 링크는 필요한 미리보기 정보를 추출하기 위해 처리되어야 합니다. 이 처리는 CPU와 메모리 자원을 소비하며, 해당 자원은 다른 작업에 쓰일 수 있는 자원입니다.
  • 클라이언트 렌더링 시간 단축: 클라이언트 측에서 링크 미리보기를 렌더링하는 데(텍스트, 이미지, 레이아웃 추가) 시간과 자원이 듭니다. 링크 미리보기를 비활성화하면 클라이언트가 이러한 요소를 렌더링할 필요가 없어 메시지가 더 빨리 표시됩니다.
  • 대역폭 절약: 링크 미리보기에는 링크된 콘텐츠의 이미지와 기타 데이터가 포함되는 경우가 많습니다. 이를 비활성화하면 해당 추가 리소스를 내려받는 데 쓰이는 대역폭을 절약할 수 있습니다.
  • 다만 링크 미리보기를 비활성화하면 사용자 경험, 커뮤니케이션 효율, 전반적인 생산성에 부정적인 영향을 줄 수 있습니다. 성능 개선과 조직 및 사용자의 필요 사이에서 균형을 잡는 것이 중요합니다.

특정 도메인에 대한 링크 미리보기를 비활성화하려면 이 설정을 사용합니다.

쉼표로 구분한 도메인 목록을 문자열로 입력합니다. 예: "mattermost.com, images.example.com"

  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > RestrictLinkPreviews
  • 환경 변수: MM_SERVICESETTINGS_RESTRICTLINKPREVIEWS
  • true: (기본값) Mattermost 메시지 공유 링크가 원본 메시지에 접근할 수 있는 사용자에게 미리보기를 생성합니다.
  • false: 공유 링크가 미리보기를 생성하지 않습니다.
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > EnablePermalinkPreviews > true
  • 환경 변수: MM_SERVICESETTINGS_ENABLEPERMALINKPREVIEWS
참고

대규모 배포에서 이 구성 설정을 비활성화하면 다음 영역에서 서버 성능이 개선될 수 있습니다. 특히 메시지 처리량이 많거나 자원이 제한된 환경에서 그렇습니다.

  • 서버 부하 감소: 퍼머링크 미리보기가 활성화되어 있으면 서버는 공유된 링크마다 미리보기 요약을 생성해야 합니다. 이는 메타데이터를 가져오기 위한 추가 요청을 발생시키고 웹페이지 파싱을 수반할 수 있어 서버의 처리 부하를 높입니다.
  • 데이터 전송량 감소: 퍼머링크 미리보기에는 이미지, 제목, 설명 같은 추가 메타데이터가 포함됩니다. 미리보기를 비활성화하면 전송해야 할 데이터양이 줄어들어 대역폭 사용량이 감소하고, 특히 링크가 많이 오가는 채널에서 메시지 로딩 시간이 개선됩니다.
  • 메시지 렌더링 속도 향상: 클라이언트 측에서 멀티미디어 미리보기가 포함된 메시지를 렌더링하는 것은 일반 텍스트 메시지보다 시간이 더 걸립니다. 미리보기를 비활성화하면 렌더링 복잡도가 줄어들어, 특히 자원이 제한된 기기에서 클라이언트 성능이 개선됩니다.
  • 네트워크 지연: 링크 미리보기용 메타데이터를 가져오려면 서버가 외부 리소스에 접근해야 하므로 네트워크 지연이 생길 수 있습니다. 이를 비활성화하면 이러한 지연이 사라져 메시지 처리와 표시가 빨라집니다.
  • 메시지 처리 단순화: 미리보기가 없으면 메시지가 더 단순해져 저장, 조회, 표시에 드는 자원이 줄어듭니다. 이는 시스템 전반의 응답성과 효율 개선으로 이어질 수 있습니다.
  • 다만 퍼머링크 미리보기를 비활성화하면 사용자 경험, 커뮤니케이션 효율, 전반적인 생산성에 부정적인 영향을 줄 수 있습니다. 성능 개선과 조직 및 사용자의 필요 사이에서 균형을 잡는 것이 중요합니다.

SVG 활성화 (Enable SVGs)

  • true: 메시지에 첨부된 SVG 파일의 미리보기를 활성화합니다.
  • false: (기본값) SVG 파일 미리보기를 비활성화합니다.
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > EnableSVGs > false
  • 환경 변수: MM_SERVICESETTINGS_ENABLESVGS
주의

모든 사용자를 신뢰할 수 없는 환경에서는 SVG 활성화를 권장하지 않습니다.

LaTeX 코드 블록 렌더링 활성화 (Enable LaTeX code block rendering)

  • true: 코드 블록 내 LaTeX 렌더링을 활성화합니다.
  • false: (기본값) 블록 내 렌더링을 비활성화합니다. 대신 LaTeX 코드가 구문 강조로 표시됩니다.
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > EnableLatex > false
  • 환경 변수: MM_SERVICESETTINGS_ENABLELATEX
주의

모든 사용자를 신뢰할 수 없는 환경에서는 LaTeX 렌더링 활성화를 권장하지 않습니다.

인라인 LaTeX 렌더링 활성화 (Enable inline LaTeX rendering)

  • true: 메시지 본문 내 LaTeX 렌더링을 활성화합니다.
  • false: (기본값) LaTeX 인라인 렌더링을 비활성화합니다. 대신 메시지 본문의 LaTeX가 구문 강조로 표시됩니다. 해당 기능이 활성화되어 있다면 코드 블록에서는 LaTeX를 렌더링할 수 있습니다. Enable LaTeX code block rendering을 참고하세요.
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > EnableInlineLatex > false
  • 환경 변수: MM_SERVICESETTINGS_ENABLEINLINELATEX
주의

모든 사용자를 신뢰할 수 없는 환경에서는 LaTeX 렌더링 활성화를 권장하지 않습니다.

맞춤 URL 스킴 (Custom URL schemes)

메시지 본문에서 자동으로 링크를 생성할 URL 스킴 목록입니다. 예: ["git", "smtp"]. 다음 스킴은 항상 링크를 생성합니다: http, https, ftp, tel, mailto.

config.json 설정: an array of strings

  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: DisplaySettings > CustomURLSchemes > []
  • 환경 변수: MM_DISPLAYSETTINGS_CUSTOMURLSCHEMES

최대 마크다운 노드 수 (Maximum Markdown nodes)

메시지의 단일 텍스트 조각에 포함될 수 있는 마크다운 요소(이모지, 링크, 표 셀 등)의 최대 개수입니다.

숫자 입력. 기본값은 0이며, 이 경우 Mattermost가 지정한 한도가 적용됩니다.

  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: DisplaySettings > MaxMarkdownNodes > 0
  • 환경 변수: MM_DISPLAYSETTINGS_MAXMARKDOWNNODES
참고

이 한도는 웹, 데스크톱 앱, 모바일 앱을 포함한 모든 Mattermost 클라이언트에 적용됩니다.

Google API 키 (Google API key)

이 설정에 키를 지정하면 Mattermost가 임베드된 YouTube 동영상의 제목을 표시하고 동영상이 더 이상 제공되지 않는지 감지합니다. 키를 설정하면 조회 수가 많은 임베드 동영상에 대해 Google이 접근을 제한하는 것도 방지할 수 있습니다.

문자열 입력.

  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > GoogleDeveloperKey
  • 환경 변수: MM_SERVICESETTINGS_GOOGLEDEVELOPERKEY
참고
  • 이 설정은 자체 호스팅 배포에만 적용됩니다.
  • 이 키는 클라이언트 측 JavaScript에서 사용되며, YouTube Data API가 서비스로 추가되어 있어야 합니다.

메시지 임시 저장본 서버 동기화 활성화 (Enable server syncing of message drafts)

지원되는 모든 Mattermost 클라이언트 간에 임시 저장 메시지를 동기화하는 기능을 활성화하거나 비활성화합니다.

  • true: (기본값) 메시지 임시 저장본이 서버에 저장되어 다른 클라이언트에서도 접근할 수 있습니다. 사용자는 Settings > Advanced Settings에서 임시 저장 메시지의 서버 동기화를 개별적으로 끌 수 있습니다.
  • false: 임시 저장 메시지가 각 기기에 로컬로 저장됩니다.
  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > AllowSyncedDrafts > true
  • 환경 변수: MM_SERVICESETTINGS_ALLOWSYNCEDDRAFTS
참고

임시 저장본은 특히 협업 환경에서 업무 연속성을 유지하는 데 매우 유용하지만, 기기 간 동기화를 비활성화하면 다음과 같이 연산 및 데이터 관리 부담이 줄어 눈에 띄는 성능 개선을 얻을 수 있습니다.

  • 데이터 동기화 감소: 임시 저장본이 활성화되어 기기 간에 동기화되면 시스템이 해당 데이터 동기화 작업을 처리해야 하며, 이는 상당한 대역폭과 컴퓨팅 자원을 소비할 수 있습니다. 임시 저장본 동기화를 비활성화하면 서버와 네트워크의 부하가 줄어듭니다.
  • 저장 공간 사용량 감소: 임시 저장본을 저장하려면 추가적인 데이터베이스 작업과 저장 공간이 필요합니다. 각 임시 저장본은 저장·관리·조회해야 할 추가 데이터입니다. 임시 저장본이 없으면 시스템이 관리할 레코드가 줄어 데이터베이스 작업이 단순해집니다.
  • 클라이언트 처리 감소: 클라이언트 측에서 임시 저장본 관리에는 변경 사항 감시, 주기적 저장, 여러 기기에서 임시 저장본이 편집될 때의 충돌 해결이 포함됩니다. 임시 저장본을 비활성화하면 이러한 클라이언트 측 처리가 줄어 메모리와 CPU 자원이 확보됩니다.
  • 아키텍처 단순화: 동기화되는 임시 저장본을 유지하려면 일관성을 보장하고 데이터 충돌을 피하기 위한 복잡한 백엔드 로직이 필요한 경우가 많습니다. 임시 저장본 동기화를 제거해 이 아키텍처를 단순화하면 백엔드 동작이 더 효율적이고 빨라질 수 있습니다.
  • 사용자 경험 개선: 임시 저장본 동기화 부담이 없으면 사용자가 더 빠른 로딩 시간과 낮은 지연을 경험할 수 있습니다. 인터넷 연결이 제한적이거나 불안정한 환경에서 특히 두드러집니다.
  • 다만 임시 저장본 동기화를 비활성화하면 사용자 경험, 커뮤니케이션 효율, 전반적인 생산성에 부정적인 영향을 줄 수 있습니다. 성능 개선과 조직 및 사용자의 필요 사이에서 균형을 잡는 것이 중요합니다.

고유 이모지 반응 개수 제한 (Unique emoji reaction limit)

메시지마다 사용할 수 있는 고유 이모지 반응의 개수를 제한합니다. 이 한도를 높이면 클라이언트 성능이 저하될 수 있습니다.

숫자 입력. 기본값은 50이고 최댓값은 500입니다.

  • 시스템 콘솔 경로: Site Configuration > Posts
  • config.json 설정: ServiceSettings > UniqueEmojiReactionLimitPerPost > 50
  • 환경 변수: MM_SERVICESETTINGS_UNIQUEEMOJIREACTIONLIMITPERPOST

콘텐츠 신고

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

시스템 콘솔에서 Site Configuration > Content Flagging으로 이동해 다음 구성 설정에 접근합니다.

콘텐츠 신고 활성화 (Enable content flagging)

  • true: 콘텐츠 신고 기능을 활성화합니다.
  • false: (기본값) 이 기능을 비활성화합니다.
  • 시스템 콘솔 경로: Site Configuration > Content Flagging
  • config.json 설정: ContentFlaggingSettings > EnableContentFlagging > false
  • 환경 변수: MM_CONTENTFLAGGINGSETTINGS_ENABLECONTENTFLAGGING

알림 설정 (Notification settings)

이벤트별 기본 알림 수신자입니다.

  • 이벤트: flagged, assigned, removed, dismissed
  • 수신자: reviewers, author, reporter

기본 매핑은 다음과 같습니다.

  • flagged = reviewers
  • assigned = reviewers
  • removed = reviewers, author, reporter
  • dismissed = reviewers, reporter
  • 시스템 콘솔 경로: Site Configuration > Content Flagging
  • config.json 설정: ContentFlaggingSettings > NotificationSettings > EventTargetMapping
  • 환경 변수: N/A

추가 설정 (Additional settings)

신고 사유를 지정합니다.

기본 사유는 다음과 같습니다.

  • Inappropriate content(부적절한 콘텐츠)
  • Sensitive data(민감 데이터)
  • Security concern(보안 우려)
  • Harassment or abuse(괴롭힘 또는 악용)
  • Spam or phishing(스팸 또는 피싱)
  • 시스템 콘솔 경로: Site Configuration > Content Flagging
  • config.json 설정: ContentFlaggingSettings > AdditionalSettings > Reasons
  • 환경 변수: N/A

신고자에게 의견 입력 요구 (Require reporters to add comment)

  • true: (기본값) 신고자는 신고할 때 반드시 의견을 입력해야 합니다.
  • false: 신고자에게 의견 입력을 요구하지 않습니다.
  • 시스템 콘솔 경로: Site Configuration > Content Flagging
  • config.json 설정: ContentFlaggingSettings > AdditionalSettings > ReporterCommentRequired > true
  • 환경 변수: MM_CONTENTFLAGGINGSETTINGS_ADDITIONALSETTINGS_REPORTERCOMMENTREQUIRED

검토자에게 의견 입력 요구 (Require reviewers to add comment)

  • true: (기본값) 검토자는 신고된 콘텐츠를 검토할 때 반드시 의견을 입력해야 합니다.
  • false: 검토자에게 의견 입력을 요구하지 않습니다.
  • 시스템 콘솔 경로: Site Configuration > Content Flagging
  • config.json 설정: ContentFlaggingSettings > AdditionalSettings > ReviewerCommentRequired > true
  • 환경 변수: MM_CONTENTFLAGGINGSETTINGS_ADDITIONALSETTINGS_REVIEWERCOMMENTREQUIRED

검토 중인 메시지를 채널에서 숨김 (Hide message from channel while it is being reviewed)

  • true: (기본값) 검토가 진행되는 동안 신고된 콘텐츠를 채널에서 숨깁니다.
  • false: 검토가 진행되는 동안에도 신고된 콘텐츠를 계속 표시합니다.
  • 시스템 콘솔 경로: Site Configuration > Content Flagging
  • config.json 설정: ContentFlaggingSettings > AdditionalSettings > HideFlaggedContent > true
  • 환경 변수: MM_CONTENTFLAGGINGSETTINGS_ADDITIONALSETTINGS_HIDEFLAGGEDCONTENT

모든 팀에 동일한 검토자 사용 (Same reviewers for all teams)

  • true: (기본값) 모든 팀에 동일한 검토자 집합을 사용합니다.
  • false: 검토자를 팀별로 관리할 수 있습니다.
  • 시스템 콘솔 경로: Site Configuration > Content Flagging
  • config.json 설정: ContentFlaggingSettings > ReviewerSettings > CommonReviewers > true
  • 환경 변수: MM_CONTENTFLAGGINGSETTINGS_REVIEWERSETTINGS_COMMONREVIEWERS

시스템 관리자를 검토자로 지정 (System administrators as reviewers)

  • true: 시스템 관리자를 검토자에 포함합니다.
  • false: (기본값) 시스템 관리자는 기본적으로 포함되지 않습니다.
  • 시스템 콘솔 경로: Site Configuration > Content Flagging
  • config.json 설정: ContentFlaggingSettings > ReviewerSettings > SystemAdminsAsReviewers > false
  • 환경 변수: MM_CONTENTFLAGGINGSETTINGS_REVIEWERSETTINGS_SYSTEMADMINSASREVIEWERS

팀 관리자를 검토자로 지정 (Team administrators as reviewers)

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

  • true: (기본값) 각 팀의 팀 관리자를 해당 팀의 검토자에 포함합니다.
  • false: 팀 관리자는 검토자에 포함되지 않습니다.
  • 시스템 콘솔 경로: Site Configuration > Content Flagging
  • config.json 설정: ContentFlaggingSettings > ReviewerSettings > TeamAdminsAsReviewers > true
  • 환경 변수: MM_CONTENTFLAGGINGSETTINGS_REVIEWERSETTINGS_TEAMADMINSASREVIEWERS

파일 공유 및 다운로드

시스템 콘솔에서 Site Configuration > File Sharing and Downloads로 이동해 다음 구성 설정에 접근합니다.

파일 공유 허용 (Allow file sharing)

  • true: (기본값) 사용자가 메시지에 파일을 첨부할 수 있습니다.
  • false: 사용자가 메시지에 파일(이미지 포함)을 첨부하지 못하게 합니다. 모바일 앱을 포함한 모든 클라이언트와 기기의 사용자에게 적용됩니다.
  • 시스템 콘솔 경로: Site Configuration > File Sharing and Downloads
  • config.json 설정: FileSettings > EnableFileAttachments > true
  • 환경 변수: MM_FILESETTINGS_ENABLEFILEATTACHMENTS

모바일에서 파일 업로드 허용 (Allow file uploads on mobile)

  • true: (기본값) 사용자가 모바일 앱에서 메시지에 파일을 첨부할 수 있습니다.
  • false: 사용자가 모바일 앱에서 메시지에 파일(이미지 포함)을 첨부하지 못하게 합니다.
  • 시스템 콘솔 경로: Site Configuration > File Sharing and Downloads
  • config.json 설정: FileSettings > EnableMobileUpload > true
  • 환경 변수: MM_FILESETTINGS_ENABLEMOBILEUPLOAD

모바일에서 파일 다운로드 허용 (Allow file downloads on mobile)

  • true: (기본값) 모바일 앱에서 파일 다운로드를 허용합니다.
  • false: 모바일 앱에서 파일 다운로드를 차단합니다. 사용자는 모바일 웹 브라우저에서는 계속 파일을 내려받을 수 있습니다.
  • 시스템 콘솔 경로: Site Configuration > File sharing and downloads
  • config.json 설정: FileSettings > EnableMobileDownload > true
  • 환경 변수: MM_FILESETTINGS_ENABLEMOBILEDOWNLOAD

모바일 보안 파일 미리보기 활성화 (Enable secure file preview on mobile)

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

이 설정은 필수적인 파일 열람 기능은 유지하면서 파일 접근을 제한해 조직의 모바일 보안 태세를 강화합니다.

  • true: 모바일에서 파일 다운로드 허용 구성 설정이 활성화되어 있더라도 대부분의 파일 형식에 대해 다운로드, 미리보기, 공유를 차단합니다. PDF, 동영상, 이미지에 한해 앱 내 미리보기를 허용합니다. 파일은 앱 캐시에 임시로 저장되며 내보내거나 공유할 수 없습니다.
  • false: (기본값) 보안 파일 미리보기 모드가 비활성화됩니다.
  • 시스템 콘솔 경로: Site Configuration > File sharing and downloads
  • config.json 설정: FileSettings > MobileEnableSecureFilePreview > false
  • 환경 변수: MM_FILESETTINGS_MOBILEENABLESECUREFILEPREVIEW

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

  • true: (기본값) 보안 파일 미리보기 모드가 켜져 있을 때 PDF 내부의 링크를 탭할 수 있습니다. 링크는 기기 브라우저나 지원되는 앱에서 열립니다.
  • false: 보안 파일 미리보기 모드가 켜져 있을 때 PDF 내 링크 이동을 차단합니다.
  • 시스템 콘솔 경로: Site Configuration > File sharing and downloads
  • config.json 설정: FileSettings > MobileAllowPdfLinkNavigation > true
  • 환경 변수: MM_FILESETTINGS_MOBILEALLOWPDFLINKNAVIGATION
참고

모바일 보안 파일 미리보기 구성 설정이 비활성화되어 있으면 이 설정은 아무 영향을 주지 않습니다.

자체 호스팅 배포에서는 시스템 콘솔에서 Site Configuration > Public Links로 이동해 다음 구성 설정에 접근할 수 있습니다.

  • true: 사용자가 Mattermost 메시지에 첨부된 파일에 대한 공개 링크를 만들 수 있습니다.
  • false: (기본값) 사용자가 파일 공개 링크를 만들지 못하게 하고, 이전에 만들어진 모든 링크를 비활성화합니다.
  • 시스템 콘솔 경로: Site Configuration > Public Links
  • config.json 설정: FileSettings > EnablePublicLink > false
  • 환경 변수: MM_FILESETTINGS_ENABLEPUBLICLINK
참고

false로 설정하면 이전에 만들어진 공개 링크에 접근하려는 사람에게 오류 메시지가 표시됩니다. 이 설정을 다시 true로 되돌리면, Public link salt를 재생성하지 않은 한 이전에 만들어진 링크에 다시 접근할 수 있습니다.

공개 파일 링크 URL에 추가되는 32자 솔트입니다. 이 설정을 변경하면 이전에 생성된 모든 링크가 무효화됩니다. 솔트는 Mattermost 설치 시 무작위로 생성되며, 시스템 콘솔에서 Regenerate를 선택해 다시 생성할 수 있습니다.

문자열 입력.

  • 시스템 콘솔 경로: Site Configuration > Public Links
  • config.json 설정: FileSettings > PublicLinkSalt
  • 환경 변수: MM_FILESETTINGS_PUBLICLINKSALT

공지

시스템 콘솔에서 Site Configuration > Notices로 이동해 다음 구성 설정에 접근합니다.

관리자 공지 활성화 (Enable admin notices)

  • true: (기본값) 시스템 관리자가 서버 업그레이드와 관리 기능에 대한 제품 내 공지를 받습니다.
  • false: 시스템 관리자가 관리자 전용 공지를 받지 않습니다. 다만 전체 사용자 대상 공지는 계속 받습니다(Enable end user notices 참고).
  • 시스템 콘솔 경로: Site Configuration > Notices -
  • config.json 설정: AnnouncementSettings > AdminNoticesEnabled > true
  • 환경 변수: MM_ANNOUNCEMENTSETTINGS_ADMINNOTICESENABLED

최종 사용자 공지 활성화 (Enable end user notices)

  • true: (기본값) 모든 사용자가 클라이언트 업그레이드와 최종 사용자 기능에 대한 제품 내 공지를 받습니다.
  • false: 사용자가 제품 내 공지를 받지 않습니다.
  • 시스템 콘솔 경로: Site Configuration > Notices
  • config.json 설정: AnnouncementSettings > UserNoticesEnabled > true
  • 환경 변수: MM_ANNOUNCEMENTSETTINGS_USERNOTICESENABLED

커넥티드 워크스페이스

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

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

커넥티드 워크스페이스가 활성화되면 시스템 관리자는 시스템 콘솔에서 Site Configuration > Connected Workspaces로 이동해 커넥티드 워크스페이스를 만들고 관리할 수 있습니다.

커넥티드 워크스페이스 활성화 (Enable connected workspaces)

Mattermost 인스턴스 간에 보안 연결을 수립하고, 사용자가 일반 공개·비공개 채널에서와 동일하게 참여할 수 있는 공유 채널로 보안 연결을 초대하는 기능을 활성화합니다.

커넥티드 워크스페이스에는 v10.2 이상을 실행하는 Mattermost Enterprise 서버가 필요합니다.

두 구성 설정 모두 기본적으로 비활성화되어 있으며, 보안 연결로 채널을 공유하려면 활성화해야 합니다. 커넥티드 워크스페이스 기능을 활성화하려면 서버를 재시작해야 합니다.

이 기능의 config.json 설정 두 가지는 다음과 같습니다.

  • ConnectedWorkspacesSettings.EnableRemoteClusterService: false, 옵션은 true와 false입니다.
  • ConnectedWorkspacesSettings.EnableSharedChannels: false, 옵션은 true와 false입니다.
참고
  • 두 설정 모두 시스템 콘솔에서 제공되지 않으며 config.json의 ConnectedWorkspacesSettings 아래에서만 설정할 수 있습니다.
  • 클라우드 배포의 시스템 관리자는 자신의 클라우드 배포 인스턴스에서 이 필수 구성 설정을 활성화해 달라고 요청할 수 있습니다.
  • Mattermost v10.2 이상으로 업그레이드하면 EnableSharedChannels와 EnableRemoteClusterService를 포함한 기존 공유 채널 구성 값이 config.json 파일의 커넥티드 워크스페이스 구성 설정으로 자동 변환됩니다. 사용 중단된 공유 채널 실험 설정은 하위 호환을 위해 config.json 파일에 그대로 남습니다.

공유 채널 상태 동기화 비활성화 (Disable shared channel status sync)

커넥티드 워크스페이스 간 구성원 상태 및 가용성 동기화를 비활성화합니다.

  • true: 채널은 물론 구성원 상태와 가용성도 동기화되지 않습니다.
  • false: (기본값) 채널은 물론 채널 구성원의 상태와 가용성도 일정 간격으로 동기화됩니다.
  • 시스템 콘솔 경로: N/A
  • config.json 설정: ConnectedWorkspacesSettings > DisableSharedChannelsStatusSync > false
  • 환경 변수: N/A
참고

이 기능들을 활성화하면 잦은 업데이트, 데이터베이스 쿼리, API 통신 때문에 Mattermost 서버의 CPU, 메모리, 데이터베이스 부하가 늘어날 수 있습니다. 동기화 주기와 재시도가 과도하면 시스템 자원이 감당하지 못해 성능 저하나 불안정이 발생할 수 있습니다. 이 기능들을 활성화할 때는 시스템을 주의 깊게 모니터링하세요.

동기화당 기본 최대 게시물 수 (Default maximum posts per sync)

한 번에 동기화할 기본 최대 메시지 수를 지정합니다.

기본값은 50입니다.

  • 시스템 콘솔 경로: N/A
  • config.json 설정: ConnectedWorkspacesSettings > DefaultMaxPostsPerSync > 50
  • 환경 변수: N/A

연결 수립 시 사용자 동기화 (Sync users on connection open)

워크스페이스 간에 새 연결이 수립될 때 사용자를 자동으로 동기화합니다. 이를 통해 원격 사용자가 공유 채널에 먼저 게시하지 않아도 다이렉트 메시지와 그룹 메시지에서 바로 검색될 수 있습니다.

  • true: (기본값) 새 연결이 수립되면 사용자가 자동으로 동기화됩니다.
  • false: 새 연결이 수립되어도 사용자가 자동으로 동기화되지 않습니다.
  • 시스템 콘솔 경로: N/A
  • config.json 설정: ConnectedWorkspacesSettings > SyncUsersOnConnectionOpen > true
  • 환경 변수: N/A
참고

이 기능들을 활성화하면 잦은 업데이트, 데이터베이스 쿼리, API 통신 때문에 Mattermost 서버의 CPU, 메모리, 데이터베이스 부하가 늘어날 수 있습니다. 동기화 주기와 재시도가 과도하면 시스템 자원이 감당하지 못해 성능 저하나 불안정이 발생할 수 있습니다. 이 기능들을 활성화할 때는 시스템을 주의 깊게 모니터링하세요.

전역 사용자 동기화 배치 크기 (Global user sync batch size)

커넥티드 워크스페이스 간 전역 사용자 동기화를 수행할 때 배치마다 동기화할 사용자 수입니다.

기본값은 100입니다.

  • 시스템 콘솔 경로: N/A
  • config.json 설정: ConnectedWorkspacesSettings > GlobalUserSyncBatchSize > 100
  • 환경 변수: N/A
참고

이 기능들을 활성화하면 잦은 업데이트, 데이터베이스 쿼리, API 통신 때문에 Mattermost 서버의 CPU, 메모리, 데이터베이스 부하가 늘어날 수 있습니다. 동기화 주기와 재시도가 과도하면 시스템 자원이 감당하지 못해 성능 저하나 불안정이 발생할 수 있습니다. 이 기능들을 활성화할 때는 시스템을 주의 깊게 모니터링하세요.

구성원 동기화 배치 크기 (Member sync batch size)

커넥티드 워크스페이스 간 채널 멤버십을 동기화할 때 배치마다 동기화할 채널 구성원 수입니다.

기본값은 100입니다.

  • 시스템 콘솔 경로: N/A
  • config.json 설정: ConnectedWorkspacesSettings > MemberSyncBatchSize > 100
  • 환경 변수: N/A
참고

이 기능들을 활성화하면 잦은 업데이트, 데이터베이스 쿼리, API 통신 때문에 Mattermost 서버의 CPU, 메모리, 데이터베이스 부하가 늘어날 수 있습니다. 동기화 주기와 재시도가 과도하면 시스템 자원이 감당하지 못해 성능 저하나 불안정이 발생할 수 있습니다. 이 기능들을 활성화할 때는 시스템을 주의 깊게 모니터링하세요.

등급 표시

Mattermost v11.8부터 시스템 관리자는 시스템 콘솔에서 Site Configuration > Classification Markings로 이동해 등급 표시를 구성할 수 있습니다.

등급 표시는 웹 및 데스크톱 앱에서 전역 배너나 채널 수준 배너로 표시할 수 있는 재사용 가능한 등급 수준을 정의합니다. 각 등급 수준은 이름, 색상, 순위 순서로 구성됩니다. US DoD, NATO, UK GSCP, Canada, Australia PSPF 같은 프리셋을 선택하거나 맞춤 등급 수준을 정의할 수 있습니다. 수준의 순서는 사용자 속성에서 사용할 수 있는 것과 동일한 Ranked 속성 유형으로 지정하므로, 각 수준은 가장 낮은 등급부터 가장 높은 등급까지 정해진 위치를 갖습니다.

참고

등급 표시는 정보 제공 목적일 뿐이며, 현재로서는 접근 제어 판단과 연결되어 있지 않습니다.

등급 표시 구성 방법:

  1. System Console > Site Configuration > Classification Markings로 이동합니다.
  2. Enable classification markings를 활성화합니다.
  3. Classification preset을 선택하거나 맞춤 등급 수준을 만듭니다.
  4. 등급 수준의 이름, 색상, 순위 순서를 구성합니다.
  5. 필요하다면 Global Classification Indicators 아래에서 Global Classification Banner를 활성화합니다.
  6. Banner visibility를 선택합니다.
    • Top only
    • Top and bottom
  7. 표시할 Global classification level을 선택합니다.
  8. Save를 선택합니다.

config.json 전용 설정

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

모든 팀 또는 특정 팀을 대상으로 검색하는 기능을 비활성화합니다.

  • true: (기본값) 팀 간 검색이 활성화됩니다. 사용자가 속한 모든 팀의 모든 채널, 특정 팀, 또는 현재 팀을 대상으로 검색할 수 있습니다.
  • false: 팀 간 검색이 비활성화됩니다. 검색은 현재 팀 내에서 사용자가 속한 모든 채널만을 대상으로 수행됩니다.
  • 시스템 콘솔 경로: N/A
  • config.json 설정: ServiceSettings.EnableCrossTeamSearch > true
  • 환경 변수: MM_SERVICESETTINGS_ENABLECROSSTEAMSEARCH