> For the complete documentation index, see [llms.txt](https://documentation.hak5.org/shark-jack-display/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.hak5.org/shark-jack-display/software-updates-1.md).
# Software Updates
Firmware updates bring bugfixes, new features, and other improvements to your device. We recommend running the latest version!
{% hint style="warning" %}
Hak5 devices are built for security professionals: They are designed with root access available and the freedom to install any software or firmware. Hak5 is committed to providing reliable, unrestricted tools and open payload platforms that you can trust. \
\
To ensure your Hak5 devices integrity, only download official firmware from [the Hak5 Download Portal](https://downloads.hak5.org/pineapple/pineapplepager) (verifiable via checksum). Genuine Hak5 firmware is *never* distributed by third party channels, and the newest firmware for your device will *always* be distributed *only* on [the Download Portal](https://downloads.hak5.org/pineapple/pineapplepager).
{% endhint %}
## Before you update
1. The Shark Jack Display will not preserve your system settings and the contents of your `/root/` directory during an upgrade. It is always a good idea before you update to back up any important data, by downloading your loot via [SSH](/shark-jack-display/access-via-ssh.md). If you have developed any custom payloads, it’s a good idea to save a copy of them as well.
2. Fully charge your device, and keep it charging while applying the software update. While not strictly necessary, we strongly encourage you to fully charge the Shark Jack Display before performing a firmware upgrade. This helps ensure there is more than enough power for the update to complete.
3. Do not unplug your Shark Jack Display during the upgrade.
## Upgrading on-device
The Shark Jack Display can self-upgrade.
1. Make sure that the Shark Jack Display [is online](/shark-jack-display/getting-the-shark-jack-online.md).
2. Make sure your time and date settings are accurate. The Shark Jack Display can automatically set the time via NTP when connected to the Internet, [if Network Time is enabled](/shark-jack-display/network-time.md). If the time and date are not accurate, SSL connections will fail.
3. Navigate to `Settings` > `System` > `Update` and choose `Update Device`
4. Download the firmware upgrade, if one is available
5. When asked to confirm installation, do so
Once the firmware upgrade process is confirmed, *it can not be cancelled or aborted*. Do *not* power off your device, disconnect it from Ethernet or power.
When the Shark Jack Display has finished updating, it will reboot automatically.
The first boot after a firmware update will take significantly longer, as the internal flash is prepared and the configuration backup is restored. Subsequent reboots will be quicker.
## Upgrading via SSH
If you do not configure the Shark Jack Display as a client device, or can not download the firmware directly on device, upgrades may also be performed over SSH.
1. Download the latest firmware from the [Hak5 Download Portal](https://downloads.hak5.org/pineapple/pager). *Remember: The only source for official firmware is the Hak5 Download Portal. The latest firmware with the latest features will ALWAYS be found on the Download Portal. Firmware from other sources claiming to be official or to have newer features may damage your device.*
2. Copy the downloaded firmware to the Shark Jack Display using `scp`. Read through [Access via SSH](/shark-jack-display/access-via-ssh.md) for more information on SSH and scp. The firmware should be copied to `/tmp`, for example, `scp sharkjack-display-1.0.0-stable-202504031414-signed.bin root@172.16.24.1:/tmp/`
3. Log in to the Shark Jack Display over SSH
4. Use the `prepare-upgrade` command to validate the firmware you copied. `prepare-upgrade /tmp/sharkjack-display-1.0.0-stable-202504031414-signed.bin`
5. Install the newly validated firmware using the `sysupgrade` command. `sysupgrade -n /tmp/firmware.bin`
When the Shark Jack Display has finished updating, it will reboot automatically.
The first boot after a firmware update will take significantly longer, as the internal flash is prepared and the configuration backup is restored. Subsequent reboots will be quicker.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://documentation.hak5.org/shark-jack-display/software-updates-1.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.