---
title: "에이전트 설치하기"
description: "AWS SSM으로 EC2 인스턴스에 Alpamon을 설치하거나 SSH로 수동 설치를 진행합니다. 설치 화면에서 명령 전송, 에이전트 설치, 서버 매칭 상태를 확인하세요. 원클릭 설치가 막히면 표시된 사유에 맞춰 조치하고, 등록된 새 서버를 서버 목록에서 열 수 있습니다."
---

> Full documentation index: https://docs.alpacax.com/llms.ko.txt

# 에이전트 설치하기

인스턴스를 온보딩하면 Alpamon 에이전트가 설치되어 관리형 Alpacon 서버가 됩니다. AWS Systems Manager(SSM)로 원클릭 설치하거나, 수동 SSH 가이드를 따를 수 있습니다.

## 원클릭 설치 (AWS SSM)

[인스턴스 인벤토리](/integrate/cloud/instances/)나 인스턴스 상세 페이지에서 **에이전트 설치**를 클릭합니다. 설치 진행 상황이 세 단계로 표시됩니다.

1. **명령 전송**: AWS Systems Manager를 통해 설치 명령이 전송됩니다.
2. **에이전트 설치**: 인스턴스에 에이전트가 설치됩니다.
3. **서버 매칭**: 인스턴스가 새 Alpacon 서버에 연결됩니다(태그, MAC, IP, 호스트명 기준).

세 단계가 모두 완료되면 **서버 보기**를 클릭해 새 서버를 엽니다. 단계가 실패하거나 시간이 초과되면 오류가 표시되며 **다시 시도**할 수 있습니다.

## 수동 설치 (SSH)

지원되지 않는 플랫폼 등으로 원클릭 설치를 사용할 수 없으면 **수동 설치 가이드**를 사용하세요. 인스턴스에서 직접 실행할 SSH 명령과 설치 스크립트가 표시되며, SSH 명령(퍼블릭 또는 사설 IP)과 설치 스크립트를 복사할 수 있습니다.

설치 스크립트에는 등록 토큰이 평문으로 포함되어 있으니 외부에 공유하지 마세요. 스크립트를 실행하면 인스턴스가 스스로 등록되고 서버에 매칭됩니다.

## 설치가 차단된 경우

**에이전트 설치**를 사용할 수 없으면 인스턴스에 **수동 설치 필요** 상태와 함께 사유, 해소 방법이 표시됩니다. 흔한 사유는 다음과 같습니다.

| 사유 | 해소 방법 |
| --- | --- |
| 이미 관리 중 | 조치가 필요 없습니다. 에이전트가 이미 실행 중입니다. |
| 설치 진행 중 | 현재 설치가 끝날 때까지 기다립니다. |
| 인스턴스 미실행 | 인스턴스를 시작한 뒤 다음 동기화를 기다립니다. |
| 원격 명령 불가 | 인스턴스를 AWS SSM 관리형 노드로 등록합니다. |
| 미지원 플랫폼 | 에이전트를 수동으로 설치하고 등록하세요. [설치 가이드](/use/servers/register/install/#windows)를 참고하세요(예: Windows). |
| 계정 비활성 | 계정 상태가 **활성**이 될 때까지 재검증합니다. |
| 원격 명령 비활성 | [계정 설정](/integrate/cloud/accounts/)에서 원격 명령을 활성화합니다. |
| 스택이 원격 설치를 허용하지 않음 | 계정의 CloudFormation 스택을 업데이트해 `EnableRemoteCommand`를 `true`로 바꾼 뒤 계정 페이지에서 권한을 다시 확인하세요. [원격 명령 권한](/integrate/cloud/accounts/#원격-명령-권한)을 참고하세요. 그동안 SSH 수동 설치는 계속 사용할 수 있습니다. |
| 등록 토큰 없음 | 계정에 [서버 등록 토큰](/use/servers/register/tokens/)을 연결합니다. |

## 온보딩 이후

온보딩된 인스턴스는 [서버](/use/servers/)에 표시되며, 다른 서버와 마찬가지로 [작업 세션](/use/work-sessions/)으로 접속합니다.

## 관련 문서

- [인스턴스 인벤토리](/integrate/cloud/instances/)
- [클라우드 계정 관리](/integrate/cloud/accounts/)
- [서버 등록하기](/use/servers/register/)

Source: https://docs.alpacax.com/ko/integrate/cloud/install-agent/