> For the complete documentation index, see [llms.txt](https://documentation.hak5.org/bash-bunny/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/bash-bunny/beginner-guides/getting-root-on-a-bash-bunny-from-the-serial-console.md).

# Getting Root on a Bash Bunny from the Serial Console

Throughout the history of personal computers, serial has been a mainstay for file transfer and console access. To this day it’s widely used, from headless servers to embedded microcontrollers. With the Bash Bunny, we’ve made it convenient as ever – without the need for a serial-to-USB converter.

![](/files/7N0v5Q5Q12QE5WsmogTg)

With dedicated shell access from the arming mode, dropping to the Bash Bunny Linux terminal is simple over serial from any OS. When combined with advanced payloads, using the serial attack mode, there’s limitless potential for creativity with this often overlooked interface.

{% embed url="<https://youtu.be/8j6hrjSrJaM>" %}

### CONNECTING TO THE SERIAL CONSOLE FROM WINDOWS

Find the COM# from Device Manager > Ports (COM & LPT) and look for USB Serial Device (COM#). Example: COM3

Alternatively, run the following powershell command to list ports:

```
[System.IO.Ports.SerialPort]::getportnames()
```

Enter COM# for serial line and 115200 for Speed. Click Open.

![PuTTY is a free and open-source terminal emulator, serial console and network file transfer application.](/files/Zsk0KUuoYwyjmcdwDCMg)

[Download PuTTY](http://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html)

### CONNECTING TO THE SERIAL CONSOLE FROM LINUX/MAC

1. Find the Bash Bunny device from the terminal

   ```
   ls /dev/tty*" or "dmesg | grep tty
   ```

   > Usually on a Linux host, the Bash Bunny will register as either `/dev/ttyUSB0` or `/dev/ttyACM0`. On an OSX/macOS host, the Bash Bunny will register as `/dev/tty.usbmodemch000001`.
2. Next, connect to the serial device using `screen`, `minicom` or your terminal emulator of choice.

   > If screen is not installed it can usually be found from your distributions package manager.
   >
   > ```
   > sudo apt install screen
   > ```
   >
   > **Connecting with screen**
   >
   > ```
   > sudo screen /dev/ttyACM0 115200
   > ```
   >
   > Disconnect with keyboard combo: `CTRL+a` followed by `CTRL+\`

User: root\
Password: hak5bunny


---

# 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, and the optional `goal` query parameter:

```
GET https://documentation.hak5.org/bash-bunny/beginner-guides/getting-root-on-a-bash-bunny-from-the-serial-console.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
