> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ipmideck.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 설치

> Docker 또는 pip로 ipmideck를 설치하고 --network host 요구 사항을 이해합니다.

## Docker (권장)

```bash theme={null}
docker run --network host ipmideck/ipmideck:latest
```

`--network host`는 컨테이너가 로컬 네트워크에서 UDP 포트 623 (IPMI/RMCP+ 포트)을 통해 BMC에
직접 도달할 수 있도록 하기 위해 필요합니다. 호스트 네트워킹이 없으면 컨테이너는 Docker의
NAT 뒤에 위치하여 하드웨어와 IPMI 세션을 완료할 수 없습니다.

컨테이너가 가동되면 `http://<your-ip>:3000`을 열고 설정 마법사를 따릅니다.

<Note>
  게시된 이미지는 Docker Hub의
  [hub.docker.com/r/ipmideck/ipmideck](https://hub.docker.com/r/ipmideck/ipmideck)에 있습니다.
  이미지는 곧 제공됩니다. 위 명령은 게시되면 실행할 정확한 명령입니다.
</Note>

## pip

```bash theme={null}
pip install ipmideck
```

pip 패키지는 호스트에 `ipmitool`이 설치되어 있어야 합니다. ipmideck는 모든 IPMI 작업에 대해
`ipmitool`을 호출합니다. 먼저 배포판의 패키지 관리자에서 설치하세요
(예: `apt install ipmitool` 또는 `dnf install ipmitool`).

## ipmideck가 데이터를 저장하는 위치

ipmideck는 구성과 데이터베이스를 데이터 디렉터리 아래에 씁니다.

* **Docker:** 컨테이너 내부의 `/data` (이미지가 `IPMIDECK_DATA_DIR=/data`를 설정합니다.
  볼륨으로 영속화하세요).
* **Linux의 pip:** 기본적으로 `/data`. 이동하려면 `IPMIDECK_DATA_DIR`을 설정합니다.
* **Windows의 pip:** `./data`. `ipmideck`를 실행하는 디렉터리 기준 상대 경로.

어떤 플랫폼에서도 `IPMIDECK_DATA_DIR` 환경 변수로 위치를 재정의할 수 있습니다.
이 디렉터리에는 `config.yaml`, SQLite 데이터베이스, 그리고 저장된 BMC 자격 증명을 보호하는 데
사용되는 암호화 키 파일이 들어 있습니다. 자세한 내용은 [구성](/ko/configuration)과
[ipmideck 실행](/ko/running)을 참조하세요.

## 다음 단계

* [구성](/ko/configuration): 포트, 폴링 간격, 보존 기간을 조정합니다.
* [지원 하드웨어](/ko/supported-hardware): BMC가 지원되는지 확인합니다.
* [문제 해결](/ko/troubleshooting): 연결 및 IPMI 오류.