데스크톱 앱 문제 해결

v6.1.0 업그레이드 후 바로 가기 깨짐(Windows MSI 전용)

Windows MSI 설치 관리자를 사용해 이전 릴리스에서 Mattermost Desktop v6.1.0으로 업그레이드한 뒤, 데스크톱이나 작업 표시줄 바로 가기에 잘못된 아이콘이 표시되거나 실행되지 않는 경우가 있습니다. 이는 이후 업그레이드에서 바로 가기의 안정성을 높이기 위해 Windows MSI 설치 관리자의 아이콘 처리 방식을 한 번 변경했기 때문입니다.

이 문제는 앱 사용 자체를 막지 않으며, v6.1.0 이전 버전에서 Windows MSI 설치 관리자로 업그레이드한 경우에만 발생합니다. 사용자는 시작 메뉴나 정상 동작하는 데스크톱 바로 가기로 Mattermost를 실행할 수 있습니다. 이후 v6.1.1 이상으로 업그레이드할 때는 바로 가기를 다시 만들 필요가 없습니다.

이 문제를 해결하려면 바로 가기를 다시 만드세요.

1. 작업 표시줄에서 깨진 바로 가기를 마우스 오른쪽 버튼으로 클릭하고 Unpin from taskbar를 선택합니다.
2. 시작 메뉴 또는 정상 동작하는 데스크톱 바로 가기로 Mattermost Desktop을 실행합니다.
3. 애플리케이션이 실행 중인 상태에서 작업 표시줄의 Mattermost 아이콘을 마우스 오른쪽 버튼으로 클릭합니다.
4. Pin to taskbar를 선택합니다.

새로 만든 바로 가기는 이후 모든 업그레이드에서 정상적으로 동작합니다.

Windows 설치 방식을 표준화하려는 조직은 Windows Store(자동 업데이트가 필요한 경우 권장)와 MSI 패키지(전통적 배포 방식) 중에서 선택할 수 있습니다. MSI 방식에는 이 한 번의 바로 가기 조정이 필요하지만, Windows Store 방식에는 필요하지 않습니다.

설정은 로컬 어디에 저장되나요?

Mattermost 데스크톱 앱 설정 파일의 위치는 Mattermost를 실행 중인 플랫폼(그리고 macOS의 경우 앱을 어떤 방식으로 설치했는지)에 따라 달라집니다.

• Windows: Users\<username>\AppData\Roaming\Mattermost
• macOS 설치 관리자: /Users/<username>/Library/Application Support/Mattermost
• macOS App Store: /Users/<username>/Library/Containers/Mattermost.Desktop/Data/Library/Application Support/Mattermost (Finder에서는 확장자가 숨겨지므로 ~/Library/Application Support/Mattermost로 표시됩니다)
• Linux: ~/.config/Mattermost

업데이트 알림이 표시되지 않음

새 버전이 나왔는데도 앱 내 업데이트 알림이 보이지 않는다면 다음을 확인하세요.

1. 인터넷 연결 확인: mattermost.com으로의 아웃바운드 HTTPS 통신이 허용되어 있는지 확인합니다.

2. 수동으로 업데이트 확인: Help > Check for Updates 또는 Settings > General > Check for Updates Now로 이동해 즉시 확인을 실행합니다.

3. 업데이트 알림이 활성화되어 있는지 확인:

   • Windows: … > File > Settings로 이동해 Automatically check for updates가 활성화되어 있는지 확인합니다.
   • macOS: Mattermost > Settings로 이동해 Automatically check for updates가 활성화되어 있는지 확인합니다.

4. 그룹 정책 설정 확인(엔터프라이즈 배포): 시스템 관리자가 EnableAutoUpdates 그룹 정책으로 업데이트 알림을 비활성화했을 수 있습니다. IT 부서에 문의해 확인하세요.

5. 이전에 건너뛴 버전: 현재 릴리스에 대해 Skip This Version을 선택했다면, 수동으로 업데이트를 확인해야 다시 표시됩니다.

업데이트 필요 화면

Mattermost 서버 v11.6.0부터 시스템 관리자는 System Console > Site Configuration > Customization > Minimum desktop app version에서 데스크톱 앱의 최소 버전을 설정할 수 있습니다. 사용 중인 데스크톱 앱 버전이 설정된 최소 버전보다 낮으면 업데이트 필요 화면이 표시되고, 업데이트하기 전까지 Mattermost에 접근할 수 없습니다.

이 화면에는 관리자가 설정한 앱 다운로드 페이지로 연결되는 Download 버튼이 있습니다. Download를 선택해 해당 페이지로 이동한 뒤, 사용 중인 플랫폼에 맞는 수동 업데이트 절차를 따르세요.

앱이 이미 최신 버전이라고 생각된다면 시스템 관리자에게 문의해 설정된 최소 버전을 확인하세요.

Mattermost Desktop 수동 업데이트 방법

v6.1.0부터 Mattermost Desktop 업데이트는 수동으로 진행합니다. 사용 중인 플랫폼에 맞는 절차를 따르세요.

macOS(App Store):

1. App Store 애플리케이션을 엽니다.
2. Updates 섹션으로 이동합니다.
3. Mattermost Desktop을 찾아 Update를 선택합니다.

macOS(DMG 설치):

1. https://mattermost.com/download 또는 GitHub 릴리스 페이지에서 최신 DMG를 내려받습니다.
2. 내려받은 DMG 파일을 엽니다.
3. Mattermost 애플리케이션을 Applications 폴더로 끌어다 놓아 기존 버전을 덮어씁니다.
4. Mattermost Desktop을 다시 시작합니다.

Windows(Microsoft Store):

1. Microsoft Store 애플리케이션을 엽니다.
2. Library > Get updates로 이동합니다.
3. Mattermost를 찾아 Update를 선택합니다.

Windows(MSI 설치):

1. GitHub 릴리스 페이지에서 최신 MSI 설치 관리자를 내려받습니다.
2. MSI 설치 관리자를 실행합니다.
3. 설치 안내를 따릅니다(기존 설치가 업그레이드됩니다).

Linux:

1. GitHub 릴리스 페이지를 방문합니다.
2. 사용 중인 배포판에 맞는 패키지(AppImage, .deb, .rpm, Flatpak 등)를 내려받습니다.
3. 패키지 관리자 또는 표준 설치 방법으로 설치합니다.

로그는 어떻게 확인하나요?

Mattermost 데스크톱 v5.3부터 Help > Show logs로 로그에 접근할 수 있으며, 로그 파일의 위치를 보여주는 파일 관리자 창이 열립니다.

앱 진단 정보는 어떻게 내려받나요?

Mattermost 데스크톱 v5.3부터 Help > Run diagnostics로 진단 텍스트 파일을 내려받을 수 있으며, 이 파일은 지원 티켓에 첨부할 수 있습니다.

멀티 뷰에서 딥 링크가 잘못된 워크스페이스로 열림

딥 링크가 잘못된 워크스페이스에서 열린다면, 관련된 모든 워크스페이스가 DefaultServerList 그룹 정책을 통해 미리 프로비저닝되어 있는지 확인하세요. 자세한 내용은 멀티 뷰와 그룹 정책 문서를 참고하세요.

• 링크가 의도한 워크스페이스로 연결되도록 워크스페이스 URL이 프로토콜과 서브도메인까지 정확히 일치하는지 확인하세요.
• 워크스페이스 목록을 편집해 오래되었거나 잘못된 항목을 수정하거나 제거한 뒤 링크를 다시 시도하세요.

여러 워크스페이스를 열었을 때 CPU 또는 메모리 사용량이 높음

여러 워크스페이스를 동시에 실행할 만큼 기기 성능이 충분한지 확인하세요. 사용하지 않는 탭과 팝아웃 창을 닫아 부하를 줄이세요.

데스크톱 앱 고급 설정을 확인하세요. 드라이버가 불안정한 시스템에서는 Use GPU hardware acceleration을 끄세요.

데스크톱 앱이 실행 중 흰 화면을 표시하고 페이지를 불러오지 못함

1. 로컬 Mattermost desktop app 설정 파일을 삭제합니다. 파일 위치는 위의 설정은 로컬 어디에 저장되나요? 섹션을 참고하세요.
2. 애플리케이션을 다시 설치합니다.

v6.1.0 업그레이드 실패 또는 중복 버전 설치(Windows MSI)

v6.1.0 MSI를 설치한 뒤에도 이전 버전이 그대로 남아 있거나, 두 버전이 함께 존재하거나, 업그레이드가 적용되지 않은 것처럼 보이는 경우가 있습니다. 이는 v5.9부터 v6.0.4까지의 사용자별 설치를 사용하고 있었기 때문입니다. v6.1.0부터 MSI 설치 관리자는 기본적으로 컴퓨터별(시스템 전역) 설치를 수행합니다. MSI 설치 관리자는 설치 컨텍스트가 다른 경우(사용자별 → 컴퓨터별) 자동으로 업그레이드할 수 없습니다.

업그레이드 전에 설치 유형을 확인하려면 파일 탐색기를 여세요.

• Mattermost가 C:\Program Files\Mattermost 또는 C:\Program Files (x86)\Mattermost에 있는 경우: 컴퓨터별 설치(업그레이드가 정상 동작합니다)
• Mattermost가 C:\Users\<YourName>\AppData\Local\...에 있는 경우: 사용자별 설치(v6.1.0 설치 전에 수동 제거가 필요합니다)

이 문제를 해결하려면 v6.1.0을 설치하기 전에 이전 버전을 수동으로 제거해야 합니다.

1. 두 버전을 모두 제거합니다.

   • Settings > Apps 또는 Control Panel > Programs and Features로 이동합니다.
   • 모든 Mattermost Desktop 항목을 제거합니다.

2. 릴리스 페이지에서 v6.1.0 MSI 설치 관리자를 다시 내려받습니다.

3. 관리자 권한으로 v6.1.0을 설치합니다(C:\Program Files\Mattermost에 설치됩니다).

4. 이후 업그레이드는 정상적으로 동작합니다.

"Installation has failed" 대화 상자

앱 데이터가 손상되었을 수 있습니다. %LOCALAPPDATA%\mattermost에 있는 파일을 모두 삭제한 뒤 앱을 다시 설치해 보세요.

"The application "Mattermost" can't be opened" 대화 상자

macOS Catalina에서 Mac Archive Utility가 파일 압축 해제의 기본 도구로 설정되어 있으면 이 대화 상자가 나타날 수 있습니다. 이 경우 Keka나 Unarchiver 같은 서드파티 도구를 사용하면 문제가 해결될 수 있습니다.

데스크톱 앱 창이 검게 표시되고 페이지를 불러오지 못함

1. 사용 가능한 최신 데스크톱 앱 버전을 설치했는지 확인합니다.

2. View > Clear Cache and Reload를 선택하거나, Windows·Linux에서는 Ctrl Shift R, Mac에서는 ⌘ ⇧ R을 눌러 캐시를 지우고 앱을 다시 불러옵니다.

3. 앱을 종료했다가 다시 시작해 문제가 해결되는지 확인합니다.

4. GPU 하드웨어 가속을 비활성화합니다.

   • Windows 또는 Linux에서는 File > Settings를 선택하고 Use GPU hardware acceleration 옵션을 해제합니다.
   • macOS에서는 Mattermost > Settings를 선택하고 Use GPU hardware acceleration 옵션을 해제합니다.

5. Optimus 같은 특수 비디오 드라이버를 사용 중이라면 비활성화해 문제가 해결되는지 확인합니다.

데스크톱 앱 창이 희게 표시되고 페이지를 불러오지 못함

1. 사용 가능한 최신 데스크톱 앱 버전을 설치했는지 확인합니다.
2. 로컬 컴퓨터에서 %userprofile%\AppData\Roaming\Mattermost 디렉터리를 삭제합니다.
3. 데스크톱 앱을 다시 설치합니다.

데스크톱 앱이 보이지 않지만 작업 표시줄에는 Mattermost 아이콘이 있음

이 문제는 Windows의 다중 모니터 환경에서 발생할 수 있습니다. Mattermost가 표시되던 모니터를 분리하면, Mattermost가 더 이상 존재하지 않는 화면 좌표에 계속 표시됩니다.

이 문제를 해결하려면 화면 위치 파일을 삭제해 데스크톱 앱의 화면 위치를 초기화할 수 있습니다. 이 파일이 없으면 데스크톱 앱은 기본적으로 주 모니터에 표시됩니다.

데스크톱 앱의 화면 위치를 초기화하려면 다음과 같이 하세요.

1. 데스크톱 앱이 실행 중이라면 작업 표시줄의 Mattermost 아이콘을 마우스 오른쪽 버튼으로 클릭한 뒤 Close Window를 선택합니다.
2. Windows 파일 탐색기를 열고 %APPDATA%\Mattermost 폴더로 이동합니다.
3. bounds-info.json 파일을 삭제합니다.

데스크톱 앱이 페이지를 계속 새로 고침함

이 문제는 localStorage가 예상치 못한 상태일 때 발생할 수 있습니다. 해결 방법은 다음과 같습니다.

• Windows: Windows 파일 탐색기를 열고 %APPDATA%\Mattermost 폴더로 이동한 뒤 Local Storage 폴더를 삭제합니다.
• Mac: Finder를 열고 ~/Library/Application Support/Mattermost 폴더로 이동한 뒤 Local Storage 폴더를 삭제합니다.
• Linux: 파일 관리자를 열고 ~/.config/Mattermost 폴더로 이동한 뒤 Local Storage 폴더를 삭제합니다. Linux 파일 관리자는 기본적으로 마침표로 시작하는 폴더를 숨길 수 있습니다. 터미널에서 rm -rf ~/.config/Mattermost로 삭제할 수도 있습니다.

데스크톱 앱이 Mattermost 서버 로그인을 계속 요구함

이 문제는 데스크톱 앱이 크래시하거나 예기치 않게 종료되어 앱 데이터가 손상된 뒤에 발생할 수 있습니다. 해결 방법은 다음과 같습니다.

• Windows: Windows 파일 탐색기를 열고 %APPDATA%\Mattermost 폴더로 이동한 뒤 IndexedDB 폴더와 Cookies, Cookies-journal 파일을 삭제합니다.
• Mac: Finder를 열고 ~/Library/Application Support/Mattermost 폴더로 이동한 뒤 IndexedDB 폴더와 Cookies, Cookies-journal 파일을 삭제합니다.
• Linux: 파일 관리자를 열고 ~/.config/Mattermost 폴더로 이동한 뒤 IndexedDB 폴더와 Cookies, Cookies-journal 파일을 삭제합니다. Linux 파일 관리자는 기본적으로 마침표로 시작하는 폴더를 숨길 수 있습니다. 터미널에서 rm -rf ~/.config/Mattermost로 삭제할 수도 있습니다.

"Internal error: BrowserWindow 'unresponsive' event has been emitted"

대화 상자에서 Show Details를 선택하면 로그를 확인할 수 있습니다. 해결 방법은 다음과 같습니다.

1. View > Clear Cache and Reload를 선택하거나, Windows·Linux에서는 Ctrl Shift R, Mac에서는 ⌘ ⇧ R을 눌러 캐시를 지웁니다.
2. File > Settings(또는 Windows·Linux에서는 Ctrl ,, Mac에서는 ⌘ ,)로 앱 설정을 열고 하드웨어 가속을 해제합니다.

Citrix Virtual Apps 또는 Desktop 환경에서 데스크톱 앱이 응답하지 않음

레지스트리 키 HKLM\SYSTEM\CurrentControlSet\Services\CtxUvi\UviProcessExcludes에 Mattermost.exe;를 추가한 뒤 시스템을 재부팅하세요.

추가 도움이 필요하면 문제 해결 포럼에서 이전에 보고된 오류를 살펴보거나, Mattermost 사용자 커뮤니티에 참여해 문제 해결 도움을 받으세요.

Linux에서 snap으로 설치한 데스크톱 앱을 제거할 수 있나요?

가능합니다. 터미널 창에서 다음 명령을 실행하세요: sudo snap remove mattermost-desktop.

데스크톱 앱 문제 신고

Mattermost 데스크톱 앱에서 발견한 문제를 신고할 때는 개발자 도구 콘솔의 내용을 이 페이지의 정보와 함께 포함하면 도움이 됩니다.

개발자 도구 콘솔에 접근하려면 다음과 같이 하세요.

1. 메뉴 바에서 View > Developer Tools > Developer Tools for Current Tab으로 이동합니다.
2. Console 탭을 선택합니다.
3. 로그 항목을 마우스 오른쪽 버튼으로 클릭한 뒤 Save As를 선택합니다.
4. 파일을 저장한 뒤 문제 설명과 함께 보냅니다.
5. 콘솔을 닫아 개발자 도구를 비활성화합니다.

데스크톱 앱에 추가한 서버마다 별도의 개발자 도구를 열 수 있습니다. 위 절차로 연 개발자 도구 콘솔에 다음 명령을 붙여 넣으면 도구를 열 수 있습니다.

document.getElementsByTagName("webview")[0].openDevTools();