> ## 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.

# Getting Started

> What ipmideck is, and how to get a dashboard running against your servers' BMCs in one command.

## What is ipmideck?

ipmideck is a self-hosted, web-based IPMI management platform. It connects to your
servers' BMC (Baseboard Management Controller) over IPMI 2.0 and gives you real-time
sensor monitoring, intelligent fan-curve control (FanPilot), remote power management,
and hardware event logs, all from your browser, no CLI required.

ipmideck runs entirely on your own network. There is no cloud, no telemetry, and no
external dependency: it talks directly to your BMCs and stores everything locally.

<Note>
  ipmideck needs to reach your BMCs over the network on UDP port 623 (the IPMI/RMCP+
  port). When you run it in Docker, use `--network host` so the container can reach
  BMCs on your LAN directly.
</Note>

## Quick start

The fastest way to try ipmideck is Docker:

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

Then open `http://<your-ip>:3000` in a browser and follow the setup wizard to add your
first server.

Prefer Python packaging? Install from PyPI instead:

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

The pip package requires `ipmitool` to be installed on the host.

<Note>
  ipmideck is in pre-release: the published Docker image and PyPI package are coming
  soon. The commands above are the exact commands you will run once they are live.
</Note>

## What you get

* **Sensor Monitoring**: live temperature, fan RPM, voltage, and power, with up to a
  year of history.
* **FanPilot**: a drag-and-drop fan-curve editor with a safe autonomous control loop.
* **Power Control**: On, Soft Off, Hard Off, Reset, and Power Cycle with a full audit log.
* **System Event Log (SEL)**: browse and export your BMC's hardware event log.
* **Hardware Inventory (FRU)**: serial numbers, part numbers, and manufacturer data.
* **Multi-Server Dashboard**: manage many BMCs from a single instance.

## Next steps

<CardGroup cols={2}>
  <Card title="Install ipmideck" icon="download" href="/en/installation">
    Docker and pip, with the `--network host` requirement explained.
  </Card>

  <Card title="First-run setup" icon="wand-magic-sparkles" href="/en/setup">
    The setup wizard: pick a login mode and add your first BMC.
  </Card>

  <Card title="Enable IPMI" icon="server" href="/en/enable-ipmi">
    Per-vendor steps to turn on IPMI-over-LAN in your BMC.
  </Card>

  <Card title="Configuration" icon="sliders" href="/en/configuration">
    Ports, polling intervals, retention, and environment overrides.
  </Card>
</CardGroup>
