---
title: "alpacon agent install-pam"
description: "CLI에서 Linux 서버에 alpamon-pam을 설치하거나 이전 버전을 업그레이드합니다. sudo with MFA 설정을 확인하고, 비대화형 실행에 필요한 확인 생략 옵션을 알아보세요. 설치 요청 후 진행 상황 조회 방법, 지원하지 않는 환경과 중복 요청의 거부 사유도 설명합니다."
---

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

# alpacon agent install-pam

Linux 서버에 alpamon-pam을 설치하거나 업그레이드합니다.

## 사용법

`alpacon agent install-pam SERVER [flags]`

## 핵심 사항

- 워크스페이스에서 sudo with MFA 활성화 필요
- 비대화형 실행에는 `--yes` 필요
- 사용자 작업 중에도 설치 가능, `--force` 플래그 없음
- 설치가 끝나기 전에 요청이 반환되므로 `alpacon exec ls`로 진행 상황 확인

## 플래그

| 플래그 | 유형 | 설명 | 기본값 |
| --- | --- | --- | --- |
| `-h, --help` | `bool` | 명령 도움말 표시 | `false` |
| `-y, --yes` | `bool` | 실행 전 확인 메시지 생략 | `false` |
| `--output` | `string` | 출력 형식: `table` 또는 `json`. 상위 명령에서 상속 | `table` |

## 예제

alpamon-pam 설치

```bash
alpacon agent install-pam my-server
```

확인 메시지 생략

```bash
alpacon agent install-pam my-server --yes
```

## 설치가 필요한 경우

Linux 서버에 alpamon-pam이 없을 때 사용하세요. [sudo with MFA](/use/work-sessions/terminal/sudo-with-mfa/)를 켰을 때 오프라인이었던 서버도 해당합니다. 서버의 [서버 관리](/use/servers/manage/#에이전트-카드)에서 **alpamon-pam 설치 또는 업그레이드**를 선택해 설치할 수도 있습니다.

## 출력

요청이 접수되면 `alpamon-pam installation requested. Run 'alpacon exec ls' to monitor progress.`를
출력합니다. 설치는 명령이 끝난 뒤 서버에서 진행되므로 [alpacon exec](/reference/cli/exec/#exec-ls)로
진행 상황을 확인하세요.

## 거부 사유

서버는 다음 세 경우에 작업을 거부합니다. 다른 에이전트 작업이 거부될 때와 같이 종료 코드는 `1`입니다.

| 코드 | 상태 | 의미 | 조치 |
|------|------|------|------|
| `server_pam_install_unsupported` | 400 | 호스트에 `alpamon-pam` 패키지가 없습니다. macOS, Windows, 또는 Alpacon이 다루지 않는 패키지 매니저를 쓰는 호스트입니다. | 설치할 것이 없습니다. sudo with MFA는 Linux 호스트에만 적용됩니다. |
| `server_pam_install_requires_sudo_with_mfa` | 400 | 워크스페이스의 **Alpacon을 통한 sudo**가 꺼져 있거나, 배포 환경에서 MFA 추가 인증을 완료할 수 없습니다. | [워크스페이스 설정 관리하기](/use/policies/server-access/)에서 설정을 켜세요. MFA 추가 인증을 완료할 수 없는 환경이라면 먼저 그 문제를 해결하세요. 설정을 켜는 것만으로는 해결되지 않습니다. |
| `server_pam_install_in_progress` | 409 | 이 서버에 아직 완료되지 않은 설치가 있습니다. | 완료된 뒤 다시 시도하세요. |

호스트에 이미 현재 버전이 설치되어 있어도 오류가 발생하지 않습니다. 요청은 접수되고 패키지 매니저가 아무것도 하지 않고
끝냅니다. 다시 설치하지 않으므로 삭제된 `/etc/sudoers.d/alpacon`도 복구하지 않습니다.
[PAM 및 sudo 문제](/use/work-sessions/terminal/troubleshoot-sudo/#sudoers-규칙이-없는-경우)를 참고하세요.

Source: https://docs.alpacax.com/ko/reference/cli/agent/install-pam/