# 설치 순서 — 포스 먼저, 에이전트는 함께

> 메인포스 설치 마법사가 동기화 에이전트까지 깔고 매장코드 · API 키를 넣어 줍니다.

> **누가** 대리점 설치 기사 · **걸리는 시간** 20분
> **준비물** 64비트 Windows PC · 서버코드 · API 키(메인포스) · 메인포스 IP(오더포스)

1. **서버에 매장 등록 — 서버코드 · API 키 확보**
2. **메인포스에 포스 설치**
   마법사에서 '메인포스' → [매장 서버 연결]에 매장코드 · API 키 → 관리자 확인(UAC) 한 번 → 에이전트가 함께 깔립니다.
3. **에이전트 확인**
   1분 안에 포스가 에이전트를 띄웁니다. 창 아래가 **'서버 ●연결됨' · 'POS ●가능'**이면 끝.
4. **오더포스 · 태블릿 · 프린터**
   메인포스와 에이전트가 정상인 뒤에 붙입니다.

<details>
<summary>왜 포스가 먼저인가요?</summary>

에이전트는 메인포스의 포스 백엔드(127.0.0.1:8900)에 붙어 일하고, 부팅 때 에이전트를 띄우는 것도 포스입니다. 에이전트만 먼저 깔면 'POS ●불가'로 동기화가 건너뛰어지고 재부팅 뒤 꺼진 채로 남을 수 있습니다. 반대로 에이전트가 없으면 판매화면에 빨간 경고 띠가 뜨고 서버 동기화 · 자동 업데이트가 멈춥니다.
</details>

> [!WARNING]
> **자주 하는 실수** — 에이전트를 오더포스에 설치한다 — 에이전트는 매장에 **1대, 메인포스에만** 둡니다. 설치 때 관리자 확인(UAC)을 거절하면 판매화면만 깔리고 에이전트가 빠집니다 → [에이전트 따로 설치](/s/storesync-agency/setup/agent-install)

## 원본 매뉴얼 자세히

화면 그림의 번호 설명은 그림 바로 아래에 있습니다. 아래는 원본 매뉴얼의 나머지 내용입니다.

<details>
<summary>📘 포스와 에이전트, 무엇을 먼저 설치하나</summary>

**포스(SMART POS 설치본)를 먼저** 설치합니다. 메인포스 설치 마법사가 동기화 에이전트를 함께 설치하고 매장코드 · API 키까지 넣어 줍니다 — 보통은 에이전트를 따로 깔 일이 없습니다.

**1.** **① 서버에 매장 등록** — 서버코드 · API 키를 받아 둡니다(장 '매장 등록 · 개통').

**2.** **② 메인포스에 포스 설치** — 마법사에서 '메인포스' → [매장 서버 연결]에 매장코드 · API 키 → 관리자 확인(UAC) 한 번 → 에이전트가 함께 깔립니다.

**3.** **③ 에이전트 확인** — 1분 안에 포스 런처가 에이전트를 띄웁니다. 에이전트 창 아래 상태가 '서버 ●연결됨' · 'POS ●가능'이면 끝(장 '동기화 에이전트').

**4.** **④ 오더포스 · 태블릿 · 프린터** — 메인포스와 에이전트가 정상인 뒤에 붙입니다.

**참고** — 왜 포스가 먼저인가 — 에이전트는 메인포스의 포스 백엔드(127.0.0.1:8900)에 붙어 일하고, 부팅 때 에이전트를 띄우는 것도 포스 런처입니다. 에이전트만 먼저 깔면 'POS ●불가'로 포스 동기화가 건너뛰어지고, 재부팅 뒤 꺼진 채로 남을 수 있습니다. 반대로 포스만 있고 에이전트가 없으면 판매화면에 빨간 '동기화 에이전트가 실행되고 있지 않습니다' 띠가 뜨고 서버 동기화 · 자동 업데이트가 멈춥니다.

**자주 하는 실수** — 에이전트를 오더포스에 설치한다 — 에이전트는 매장에 1대, **메인포스에만** 둡니다.
설치 때 관리자 확인(UAC)을 거절했다 — 판매화면만 깔리고 에이전트는 빠집니다. 장 '동기화 에이전트 → 따로 설치하기'대로 설치합니다.
</details>