🧭설치 순서 — 포스 먼저, 에이전트는 함께
메인포스 설치 마법사가 동기화 에이전트까지 깔고 매장코드 · API 키를 넣어 줍니다.
- 64비트 Windows PC
- 서버코드 · API 키(메인포스)
- 메인포스 IP(오더포스)
- 1서버에 매장 등록 — 서버코드 · API 키 확보
- 2메인포스에 포스 설치
마법사에서 '메인포스' → [매장 서버 연결]에 매장코드 · API 키 → 관리자 확인(UAC) 한 번 → 에이전트가 함께 깔립니다.
- 3에이전트 확인
1분 안에 포스가 에이전트를 띄웁니다. 창 아래가 '서버 ●연결됨' · 'POS ●가능'이면 끝.
- 4오더포스 · 태블릿 · 프린터
메인포스와 에이전트가 정상인 뒤에 붙입니다.
›왜 포스가 먼저인가요?
에이전트는 메인포스의 포스 백엔드(127.0.0.1:8900)에 붙어 일하고, 부팅 때 에이전트를 띄우는 것도 포스입니다. 에이전트만 먼저 깔면 'POS ●불가'로 동기화가 건너뛰어지고 재부팅 뒤 꺼진 채로 남을 수 있습니다. 반대로 에이전트가 없으면 판매화면에 빨간 경고 띠가 뜨고 서버 동기화 · 자동 업데이트가 멈춥니다.
원본 매뉴얼 자세히#
화면 그림의 번호 설명은 그림 바로 아래에 있습니다. 아래는 원본 매뉴얼의 나머지 내용입니다.
›📘 포스와 에이전트, 무엇을 먼저 설치하나
포스(SMART POS 설치본)를 먼저 설치합니다. 메인포스 설치 마법사가 동기화 에이전트를 함께 설치하고 매장코드 · API 키까지 넣어 줍니다 — 보통은 에이전트를 따로 깔 일이 없습니다.
1. ① 서버에 매장 등록 — 서버코드 · API 키를 받아 둡니다(장 '매장 등록 · 개통').
2. ② 메인포스에 포스 설치 — 마법사에서 '메인포스' → [매장 서버 연결]에 매장코드 · API 키 → 관리자 확인(UAC) 한 번 → 에이전트가 함께 깔립니다.
3. ③ 에이전트 확인 — 1분 안에 포스 런처가 에이전트를 띄웁니다. 에이전트 창 아래 상태가 '서버 ●연결됨' · 'POS ●가능'이면 끝(장 '동기화 에이전트').
4. ④ 오더포스 · 태블릿 · 프린터 — 메인포스와 에이전트가 정상인 뒤에 붙입니다.
참고 — 왜 포스가 먼저인가 — 에이전트는 메인포스의 포스 백엔드(127.0.0.1:8900)에 붙어 일하고, 부팅 때 에이전트를 띄우는 것도 포스 런처입니다. 에이전트만 먼저 깔면 'POS ●불가'로 포스 동기화가 건너뛰어지고, 재부팅 뒤 꺼진 채로 남을 수 있습니다. 반대로 포스만 있고 에이전트가 없으면 판매화면에 빨간 '동기화 에이전트가 실행되고 있지 않습니다' 띠가 뜨고 서버 동기화 · 자동 업데이트가 멈춥니다.
자주 하는 실수 — 에이전트를 오더포스에 설치한다 — 에이전트는 매장에 1대, 메인포스에만 둡니다.
설치 때 관리자 확인(UAC)을 거절했다 — 판매화면만 깔리고 에이전트는 빠집니다. 장 '동기화 에이전트 → 따로 설치하기'대로 설치합니다.