---
title: "서버 제거하기"
description: "서버를 제거할 때는 먼저 Alpamon 에이전트를 해제합니다. 필요하다면 워크스페이스에 남은 서버 등록 기록도 별도로 삭제하세요. 여러 서버를 일괄 삭제하거나 오프라인 서버를 처리할 때의 주의사항을 확인하고, 해제 후 남는 정보와 삭제되는 기록을 정확히 구분할 수 있습니다."
---

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

# 서버 제거하기

Alpacon에서 더 이상 관리하지 않을 서버를 제거할 수 있습니다.

이 문서는 워크스페이스를 유지하면서 개별 서버를 제거하는 방법을 설명합니다. 워크스페이스를 삭제하면 응답하는 연결된 서버에서 Alpacon이 제거됩니다. 다만 오프라인 서버나 지원되지 않는 호스트는 예외입니다. 자세한 내용은 [서버에 미치는 영향](/use/workspace/delete/#서버에-미치는-영향)을 참고하세요.

## 제거 절차

서버를 제거하는 방법은 두 가지입니다.

- **`alpamon unregister`**(v2.3.0+): 호스트의 에이전트를 제거하고, 워크스페이스 레코드 삭제를 best-effort로 시도하는 작업을 한 번에 수행합니다.
- **수동**: (1) 서버에서 Alpamon 에이전트를 제거한 뒤, (2) Alpacon 워크스페이스에서 서버를 삭제합니다.

두 방법 모두 아래에서 설명합니다.

## 1. Alpamon 에이전트 제거

먼저 서버에서 에이전트를 제거해야 합니다.

가장 빠른 방법은 `alpamon unregister`입니다. 서비스를 중지·제거하고, 로컬 설정을 삭제하며, 워크스페이스 서버 레코드 삭제를 best-effort로 시도하는 작업을 한 번에 수행합니다. Websh가 아닌 서버에서 직접, alpamon v2.3.0 이상에서 실행하세요.

```bash

# Linux / macOS
sudo alpamon unregister --yes
```

```powershell

# Windows (elevated PowerShell, on the server)
& "$env:ProgramFiles\alpamon\alpamon.exe" unregister --yes
```

등록이 막힌 호스트를 복구하려면 `alpamon register --force`를 사용하세요. [재등록 및 복구](/use/servers/troubleshooting/#재등록-및-복구)를 참고하세요.

아래 OS별 단계는 에이전트와 파일을 수동으로 제거하며, v2.3.0 미만 에이전트에도 적용됩니다.

### Debian 기반 시스템 (Ubuntu, Debian)

**기본 제거:**
```bash
sudo apt remove alpamon -y && sudo rm -rf /etc/alpamon/alpamon.conf
```

**완전 제거 (모든 파일 포함):**
```bash
sudo apt remove alpamon --purge -y
```

완전 제거 시 다음 파일들도 삭제됩니다:
- `/etc/alpamon/alpamon.conf`
- `/usr/lib/tmpfiles.d/alpamon.conf`
- `/lib/systemd/system/alpamon.service`
- `/lib/systemd/system/alpamon-restart.service`
- `/lib/systemd/system/alpamon-restart.timer`
- `/var/log/alpamon/alpamon.log`
- `/var/lib/alpamon/alpamon.db`

### Red Hat 기반 시스템 (RHEL, Rocky Linux)

**기본 제거:**
```bash
sudo yum remove alpamon
```

**완전 제거 (모든 파일 포함):**
```bash
sudo yum remove alpamon && \
sudo rm -f /etc/alpamon/alpamon.conf \
&& sudo rm -f /usr/lib/tmpfiles.d/alpamon.conf \
&& sudo rm -f /lib/systemd/system/alpamon.service \
&& sudo rm -f /lib/systemd/system/alpamon-restart.service \
&& sudo rm -f /lib/systemd/system/alpamon-restart.timer \
&& sudo rm -f /var/log/alpamon/alpamon.log \
&& sudo rm -f /var/lib/alpamon/alpamon.db
```

### SUSE 기반 시스템 (openSUSE, SLES)

**기본 제거:**
```bash
sudo zypper --non-interactive remove alpamon
```

**완전 제거 (설정, 데이터, 로그 포함):**
```bash
sudo zypper --non-interactive remove alpamon
rpm -q alpamon >/dev/null || sudo rm -rf /etc/alpamon /var/lib/alpamon /var/log/alpamon  # only once the package is gone
```

### macOS

launchd 서비스를 중지하고 plist를 삭제한 뒤 Homebrew 패키지를 제거하면 실행 파일도 삭제됩니다. 설정 파일은 `/etc/alpamon/alpamon.conf`에 있습니다. 설정과 데이터, 로그도 필요하지 않으면 함께 지우세요.

```bash
sudo launchctl unload /Library/LaunchDaemons/com.alpacax.alpamon.plist
sudo rm -f /Library/LaunchDaemons/com.alpacax.alpamon.plist
brew uninstall alpamon
sudo rm -rf /etc/alpamon /var/lib/alpamon /var/log/alpamon
```

### Windows

관리자 권한 PowerShell에서 실행합니다. 폴더를 지우기 전에 서비스를 먼저 중지·삭제하세요. 그러지 않으면 사용 중(sharing violation) 오류로 제거가 실패합니다.

```powershell
sc.exe stop alpamon
sc.exe delete alpamon
Remove-Item -Recurse -Force "$env:ProgramFiles\alpamon"
Remove-Item -Recurse -Force "$env:ProgramData\alpamon"
```

Windows 서비스와 파일이 제거됐는지 확인하세요:

```powershell
sc.exe query alpamon
Test-Path "C:\Program Files\alpamon"
Test-Path "$env:ProgramData\alpamon"
```

`sc.exe query`에서 1060이 나오면 서비스가 제거된 것입니다. 두 경로는 모두 `False`여야 합니다.

[Windows 서버](/reference/platforms/windows/)를 참고하세요.

## 2. 워크스페이스에서 서버 삭제

위의 수동 OS별 단계로 에이전트를 제거했다면(`alpamon unregister`가 아니라) 워크스페이스에 서버 레코드가 남아 있으므로 여기서 삭제합니다. `alpamon unregister`는 레코드 삭제를 자동으로 시도하지만, 워크스페이스에 접근하지 못하면(네트워크·토큰 문제) 서버가 목록에 남을 수 있으니 그럴 때 여기서 삭제하세요.

**필수 조건:**
- 서버 상태가 **연결되지 않음**이어야 합니다
- 권한: 할당된 그룹의 소유자(Owner) 또는 관리자(Manager), [서버의 maintainer](/use/workspace/settings/roles/#권한-상속-및-누적), Staff 또는 Superuser 역할을 가진 사용자

**삭제 방법:**

1. **Servers** 페이지로 이동합니다
2. 삭제할 서버를 선택합니다(체크박스)
3. 상단의 **삭제(휴지통)** 아이콘을 클릭합니다
4. 확인 모달에서 **연결 해제**를 클릭합니다
5. 서버가 목록에서 제거됩니다

## 일괄 삭제

여러 서버를 한 번에 삭제할 수 있습니다.

1. 삭제할 여러 서버를 선택합니다
2. 휴지통 아이콘을 클릭합니다
3. 확인합니다
4. 선택한 모든 서버가 삭제됩니다

## 주의사항

**삭제 후 남는 정보와 사라지는 정보:**

| 정보 | 서버 삭제 후 |
| --- | --- |
| 서버 설정 | 관리 대상 목록에서 서버가 사라지고 그룹 및 접근 규칙 할당이 해제됩니다. 다시 등록한다면 설정을 새로 구성해야 합니다. |
| 모니터링 기록 | 삭제한 서버의 모니터링 페이지를 열 수 없어 이전 차트도 그곳에서 볼 수 없습니다. 서버를 삭제한다고 저장된 메트릭이 모두 즉시 지워지는 것은 아닙니다. |
| 명령어 실행 기록 | 이전 명령어와 상세 정보, 출력은 권한이 있는 사용자가 해당 감사 조회 기간에 [명령어 감사 기록](/use/audit/events/commands/)에서 볼 수 있습니다. |
| 접근 로그 | 이전 Websh와 WebFTP 활동은 해당 감사 조회 기간에 기록으로 남습니다. |
| 코멘트 | 서버에 남긴 메모는 삭제됩니다. 필요한 내용은 서버를 제거하기 전에 저장하세요. |

**재등록해도 이전 서버는 복구되지 않습니다:** 같은 호스트를 다시 등록하면 새로운 관리 대상 서버가 됩니다. 이전 설정, 모니터링 페이지, 메모는 돌아오지 않습니다. 남아 있는 감사 기록은 새 서버 등록에 연결되지 않습니다.

**에이전트 먼저 제거:**
- 에이전트를 제거하지 않고 Alpacon에서만 삭제하면, 서버가 계속 연결을 시도해 불필요하게 리소스를 소모할 수 있습니다

## 재등록

제거한 서버를 다시 등록하려면 다음과 같이 진행합니다.

1. [서버 등록하기](/use/servers/register/) 절차를 다시 따릅니다
2. 새 설치 스크립트가 생성됩니다
3. 새 서버의 설정을 다시 구성합니다. 이전 감사 기록은 새 등록에 연결되지 않습니다

## 문제 해결

**서버가 Disconnected 상태로 변경되지 않는 경우:**
1. 서버에서 에이전트가 완전히 제거되었는지 확인합니다.
```bash
systemctl status alpamon
```
2. 에이전트가 여전히 실행 중이면 수동으로 중지합니다.
```bash
sudo systemctl stop alpamon
sudo systemctl disable alpamon
```
Windows에서는 대신 PowerShell로 서비스를 확인하고 중지합니다.
```powershell
sc.exe query alpamon
Stop-Service alpamon
```

**삭제 버튼이 비활성화된 경우:**
- 서버 상태를 확인하세요(Connected 상태에서는 삭제할 수 없습니다)
- 이 서버를 관리할 수 있는지 확인하세요(서버의 maintainer, 할당된 그룹의 소유자·관리자, Staff·Superuser)

## 관련 문서

- [서버 등록하기](/use/servers/register/)
- [서버 관리하기](/use/servers/manage/)

Source: https://docs.alpacax.com/ko/use/servers/remove/