> For the complete documentation index, see [llms.txt](https://docs.weka.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.weka.io/6.0/planning-and-installation/system-installation-on-bare-metal-servers/install-wpa.md).

# Install WPA

Install the WEKA Platform Appliance (WPA) on each bare metal server.

WPA is an operating system image based on Ubuntu 24.04 Server Minimal.&#x20;

The WPA `iso` does not need internet access during the installation – all included packages are set to their latest versions as of the WPA release date, and the Linux kernel package is pinned to the latest major+minor release line that is known to work with WEKA.

See the `cloud-init` config file on each WPA release page in [get.weka.io](https://get.weka.io) for further details about the included packages and system settings.&#x20;

The WPA release cycle is designed to prioritize a secure installation experience. So new WPA images are released regularly and independently of the WEKA software release cycle. As such, WEKA software is intentionally not included in the WPA `iso`.&#x20;

Please download and install your WEKA software release from [get.weka.io](https://get.weka.io) after the WPA installation has completed.<br>

**Before you begin**

* Make sure each server meets the following requirements:
  * **Boot type:** UEFI.
  * **Boot drive:** At least one drive of 64 GiB or larger. WPA ignores smaller drives. When WPA finds two installation drives of the same size, it installs the operating system on the first drive and uses the second drive for `/opt/weka`. WPA does not mirror the two drives.
* Download the WPA ISO image. See [Obtain the installation packages](https://docs.weka.io/6.0/planning-and-installation/system-installation-on-bare-metal-servers/obtain-the-installation-packages.md).
* When you download WPA from [get.weka.io](https://get.weka.io), record the server sign-in credentials under **OS login**.
* Make sure you can boot each server from the ISO image, through the server's BMC virtual media or from USB media.

{% hint style="warning" %}
WPA selects the slowest drive or pair of drives for the bootable operating system partition and the `/opt/weka` partition.&#x20;

WPA installs the operating system on the first match from the following list of devices: a Dell BOSS device, a hardware RAID virtual disk, a SATA/M.2 drive or matching pair of dives, the smallest NVMe drive or smallest matching pair of NVMe drives.

Before you install, back up or disconnect any drive that holds data you need.
{% endhint %}

**Procedure**

1. **Install WPA:** Boot the server from the WPA ISO image. Use one of the following methods:
   * **BMC virtual media:** Copy the WPA ISO image to a location that the server's BMC can mount as a virtual DVD, such as a workstation connected to the BMC web interface, an SMB share, or an NFS share. For mounting and booting from the image, see the documentation for the server's BMC (for example, iLO, iDRAC, or IPMI).
   * **USB media:** Write the WPA ISO image to a USB drive, and boot the server from it.
2. **Wait for the installation to complete:** The boot menu starts the automatic installation after 30 seconds. The installer partitions the drives, installs and configures the operating system, installs the required packages, and reboots the server.

   To follow the installation on a server without a monitor, open the BMC serial-over-LAN console (115200 baud).
3. **Sign in to the server console:** The login credentials are provided on the WPA download page on [get.weka.io](https://get.weka.io). \
   The WPA sets the host name to `weka-` followed by the last segment of the server's DMI serial number. \
   The WPA enables DHCP on the management interface but makes no further assumptions about the installation network — so each NIC will need to be configured for each server.
4. Verify the installed WPA version:

```bash
cat /etc/wpa-release
```

The `PRETTY_NAME` field shows the WPA version, for example `WPA-1.2.1`.

Repeat the procedure on each server.

## What to do next?

Go to [Install the WEKA software](https://docs.weka.io/6.0/planning-and-installation/system-installation-on-bare-metal-servers/install-the-weka-software.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.weka.io/6.0/planning-and-installation/system-installation-on-bare-metal-servers/install-wpa.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
