Jonot 설치

모든 Jonot 네이티브 바이너리는 downloads.jonot.io에 게시됩니다. 모든 릴리스는 버전이 고정된 아카이브 경로(불변이므로 고정해 두기 안전)와 latest/ 경로 (릴리스마다 갱신되며 캐시 TTL이 짧음)를 함께 제공합니다.

Jonot Host

Jonot Host 앱은 백오피스 Linux 머신에서 실행되며, 인터넷 장애 중에도 대기열을 계속 운영하고 연결이 복구되면 자동으로 동기화합니다.

Linux

패키지	링크
Debian / Ubuntu (.deb)	jonot-host-linux.deb
Fedora / RHEL (.rpm)	jonot-host-linux.rpm

apt로 설치 (Debian / Ubuntu)

Jonot 저장소를 한 번만 추가하면, 이후 업데이트는 apt upgrade로 진행합니다:

curl -fsSL https://downloads.jonot.io/host/latest/jonot-host-public.asc \
  | sudo gpg --dearmor -o /usr/share/keyrings/jonot-host.gpg
echo "deb [signed-by=/usr/share/keyrings/jonot-host.gpg] https://downloads.jonot.io/host/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/jonot-host.list
sudo apt update && sudo apt install jonot-host

dnf/rpm으로 설치 (Fedora / RHEL)

Jonot 저장소를 한 번만 추가하면, 이후 업데이트는 dnf upgrade로 진행합니다:

sudo rpm --import https://downloads.jonot.io/host/latest/jonot-host-public.asc
sudo tee /etc/yum.repos.d/jonot-host.repo <<'REPO'
[jonot-host]
name=Jonot Host
baseurl=https://downloads.jonot.io/host/rpm
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://downloads.jonot.io/host/latest/jonot-host-public.asc
REPO
sudo dnf install jonot-host

macOS 및 Windows

패키지	링크
macOS (.dmg)	JonotHost-latest.dmg
Windows (.msi)	JonotHost-latest.msi

macOS와 Windows 빌드는 설치 후 자체적으로 업데이트됩니다: macOS는 Sparkle, Windows는 WinSparkle을 사용합니다. Linux .deb / .rpm 패키지는 위에서 설정한 apt/dnf 저장소를 통해 업데이트됩니다.

데스크톱 Jonot Kiosk, Desk, Display 클라이언트

키오스크, 창구, 디스플레이 앱은 네이티브 데스크톱 클라이언트(Windows, macOS, Linux)로도 실행됩니다. 이 클라이언트들은 동일한 키오스크/창구/디스플레이 웹 앱을 내장된 Chromium 기반 브라우저 엔진(최초 실행 시 한 번만 다운로드)에 포함하므로, 브랜딩과 지원되는 모든 언어, 실시간 동기화를 그대로 사용할 수 있습니다. 키오스크와 창구 클라이언트는 브라우저가 할 수 없는 네이티브 기능을 추가로 제공합니다: TCP/9100을 통한 로컬 영수증 인쇄와 인터넷 장애 시 온프레미스 호스트로의 자동 전환입니다. 키오스크 클라이언트는 바로가기 키 차단과 PIN으로 보호되는 종료 기능을 갖춘 전체 화면으로도 실행됩니다. 디스플레이 클라이언트는 출력 전용으로 — 인쇄나 PIN으로 보호되는 종료 기능이 없으며 — OS 자체의 전원 설정에 의존하지 않고 macOS와 Windows에서 화면이 꺼지지 않도록 자동으로 유지합니다.

클라이언트는 설치 후 자체적으로 업데이트됩니다: macOS는 Sparkle, Windows는 WinSparkle을 사용합니다. Linux의 .deb와 .rpm은 관리되는 저장소가 없는 독립 패키지이므로, 새 패키지를 다운로드하여 설치하는 방식으로 업데이트합니다.

Jonot Kiosk (desktop)

패키지	링크
macOS (.dmg)	JonotKiosk-latest.dmg
Windows (.msi)	JonotKiosk-latest.msi
Debian / Ubuntu (.deb, amd64)	jonot-kiosk-linux-amd64.deb
Debian / Ubuntu (.deb, arm64)	jonot-kiosk-linux-arm64.deb
Fedora / RHEL (.rpm, amd64)	jonot-kiosk-linux-amd64.rpm
Fedora / RHEL (.rpm, arm64)	jonot-kiosk-linux-arm64.rpm

Jonot Desk (desktop)

패키지	링크
macOS (.dmg)	JonotDesk-latest.dmg
Windows (.msi)	JonotDesk-latest.msi
Debian / Ubuntu (.deb, amd64)	jonot-desk-linux-amd64.deb
Debian / Ubuntu (.deb, arm64)	jonot-desk-linux-arm64.deb
Fedora / RHEL (.rpm, amd64)	jonot-desk-linux-amd64.rpm
Fedora / RHEL (.rpm, arm64)	jonot-desk-linux-arm64.rpm

Jonot Display (desktop)

패키지	링크
macOS (.dmg)	JonotDisplay-latest.dmg
Windows (.msi)	JonotDisplay-latest.msi
Debian / Ubuntu (.deb, amd64)	jonot-display-linux-amd64.deb
Debian / Ubuntu (.deb, arm64)	jonot-display-linux-arm64.deb
Fedora / RHEL (.rpm, amd64)	jonot-display-linux-amd64.rpm
Fedora / RHEL (.rpm, arm64)	jonot-display-linux-arm64.rpm

변조 방지가 필요한 공개 설치 환경에서는 데스크톱 키오스크 아래에 OS 수준의 키오스크 프로필을 추가로 적용하세요 — 데스크톱 키오스크 잠금 설정을 참고하세요.

Windows: 보안 경고 우회하기

Windows .msi 설치 프로그램은 아직 코드 서명이 되어 있지 않습니다 (Authenticode 서명은 예정되어 있음). 서명되기 전까지 Windows는 이 앱을 **“알 수 없는 게시자”**로 표시하며, Microsoft Edge와 Microsoft Defender SmartScreen 모두 처음 다운로드하고 실행할 때 파일을 차단합니다. 이는 예상된 동작으로 — 새로 나온, 다운로드 수가 적은 모든 설치 프로그램에서 일어나는 현상이며 다운로드 자체에 문제가 있다는 뜻은 아닙니다.

다운로드가 정상인지 확인하는 방법

브라우저의 판단만 믿을 필요는 없습니다. 모든 데스크톱 릴리스는 서명된 SHA256SUMS 파일도 함께 게시합니다 — 아래 다운로드 확인을 따라 실행하기 전에 .msi가 Jonot이 게시한 파일과 바이트 단위로 동일한지 확인하세요.

1단계 — Microsoft Edge에서 다운로드 허용하기

Edge는 처음에 파일 보관을 거부하며 “JonotDesk-x.y.z.msi 파일은 자주 다운로드되는 파일이 아닙니다. 파일을 열기 전에 신뢰할 수 있는지 확인하세요.” 라는 메시지를 표시합니다. (정확한 파일명은 사용한 링크에 따라 다르며, latest/ 링크는 JonotDesk-latest.msi로 다운로드됩니다.)

다운로드 패널(도구 모음의 ↓ 아이콘)을 열고, 차단된 항목 위에 마우스를 올린 뒤 옆의 ⋯(추가 작업) 버튼을 클릭하여 유지를 선택하세요.

Edge는 한 번 더 확인을 요청합니다 — “파일을 열기 전에 JonotDesk-x.y.z.msi을(를) 신뢰할 수 있는지 확인하세요.” 계속 유지 버튼을 클릭하세요(분할된 삭제 버튼을 펼쳐야 보일 수 있습니다).

이제 다운로드가 유지되고 파일 열기 링크가 나타납니다. 클릭하여 설치 프로그램을 실행하세요.

참고

다른 브라우저도 동일한 방식의 프롬프트를 표시합니다. Chrome에서는 차단된 다운로드의 동일한 추가 메뉴에 유지 옵션이 있으며, Firefox에서는 항목을 마우스 오른쪽 버튼으로 클릭하고 다운로드 허용을 선택하세요.

2단계 — SmartScreen을 통과하여 앱 실행 허용하기

설치 프로그램을 처음 실행하면 Microsoft Defender SmartScreen이 **“Windows에서 PC를 보호했습니다 … 인식할 수 없는 앱이 시작되지 않도록 했습니다.”**라는 메시지로 차단합니다. 실행 버튼은 숨겨져 있으므로 — 추가 정보 링크를 클릭하여 표시하세요.

그러면 SmartScreen이 앱 이름과 게시자를 표시하고, 실행 안 함 옆에 계속 실행 버튼이 나타납니다. 계속 실행을 클릭하여 설치 프로그램을 시작하세요.

이후 MSI 설치 프로그램은 정상적으로 진행됩니다. 이러한 프롬프트는 설치 프로그램을 다운로드하고 처음 실행할 때만 표시되며, 설치된 앱은 이후에는 프롬프트 없이 실행됩니다. WinSparkle이 제공하는 즉시 업데이트는 브라우저 밖에서 다운로드되므로 Edge의 다운로드 경고는 건너뛰지만, 앱이 충분한 평판을 쌓기 전까지는 업데이트된 설치 프로그램에 대해 SmartScreen이 한 번 더 표시될 수 있습니다. 설치 프로그램이 코드 서명되고 서명 인증서가 SmartScreen 평판을 충분히 쌓으면 두 프롬프트 모두 사라집니다.

Android 앱

Jonot Kiosk (Android)

태블릿용 셀프 체크인 키오스크.

설치 방법	링크
Google Play (권장)	Google Play에서 다운로드
직접 APK (온프레미스 / MDM)	jonot-kiosk.apk

Jonot Desk (Android)

번호표를 호출하고 관리하는 직원용 창구 앱.

설치 방법	링크
Google Play (권장)	Google Play에서 다운로드
직접 APK (온프레미스 / MDM)	jonot-desk.apk

관리자 없는 재부팅 이후의 오프라인 호스트

Android 창구를 온프레미스 오프라인 호스트로 사용하는 경우(키오스크 없이 창구만 있는 지점), 한 가지 예외 상황에 유의하세요: 인터넷이 이미 끊긴 상태에서 관리자 없이 재부팅되면, 직원이 앱을 한 번 열기 전까지는 창구가 호스트 역할을 다시 시작하지 않습니다. 창구가 열려 있고 사용 중일 때의 장애 전환은 정상적으로 동작하며 — WAN이 이미 끊긴 상태에서 재부팅된 경우에만 복구를 위해 한 번의 조작이 필요합니다.

Jonot Display (Android)

TV, 모니터, 태블릿용 출력 전용 대기열 디스플레이이며, Android TV와 Fire TV도 포함됩니다.

설치 방법	링크
Google Play (권장)	Google Play에서 다운로드
직접 APK (온프레미스 / MDM)	jonot-display.apk

다운로드 검증하기

데스크톱 호스트, 데스크톱 키오스크, 데스크톱 창구, 데스크톱 디스플레이는 각각 자체 <app>/latest/ 경로 아래에 자체 SHA256SUMS / SHA256SUMS.asc / Jonot<App>-public.asc를 게시합니다(예: host/latest/jonot-host-public.asc, kiosk/latest/JonotKiosk-public.asc, desk/latest/JonotDesk-public.asc, display/latest/JonotDisplay-public.asc). 네 파일 모두 동일한 Jonot 릴리스 GPG 키(C2EF 70E9 7821 0056 C5C8 2F42 E588 CB26 8697 F7C3)로 서명되어 있습니다. 분리된 서명은 SHA256SUMS.asc에 들어 있습니다. 서명을 검증하면 체크섬 파일이 Jonot에 의해 게시되었음을 증명하고, 체크섬은 다운로드한 바이너리가 게시된 것과 일치함을 증명합니다.

참고: .dmg는 SHA256SUMS가 아닌 macOS Gatekeeper와 공증(notarization)으로 검증되므로, sha256sum -c --ignore-missing은 .deb, .rpm, .msi는 검증하지만 .dmg는 검증하지 않습니다.

아래 단계는 호스트를 예시로 사용합니다. 다른 앱의 경우 kiosk, desk, display(및 JonotKiosk-public.asc, JonotDesk-public.asc, JonotDisplay-public.asc)로 바꿔서 진행하세요.

1단계 — 체크섬 파일과 공개 키 다운로드하기

curl -fsSLO https://downloads.jonot.io/host/latest/SHA256SUMS
curl -fsSLO https://downloads.jonot.io/host/latest/SHA256SUMS.asc
curl -fsSLO https://downloads.jonot.io/host/latest/jonot-host-public.asc

2단계 — 키 지문 가져오기 및 확인하기

gpg --import jonot-host-public.asc
gpg --fingerprint C2EF70E978210056C5C82F42E588CB268697F7C3

지문은 C2EF 70E9 7821 0056 C5C8 2F42 E588 CB26 8697 F7C3와 정확히 일치해야 합니다. 일치하지 않으면 다운로드한 파일을 폐기하세요.

3단계 — 체크섬 파일 서명 확인하기

gpg --verify SHA256SUMS.asc SHA256SUMS

Good signature from "Jonot Release <releases@jonot.io>"가 표시되어야 합니다.

4단계 — 다운로드한 파일 확인하기

sha256sum -c SHA256SUMS --ignore-missing

OK 결과가 나오면 파일이 온전함을 확인한 것입니다.

릴리스 노트

버전별 릴리스 노트는 호스트 변경 이력을 참고하세요. 모든 네이티브 앱 릴리스는 GitHub Releases 페이지에도 목록으로 제공됩니다.