> For the complete documentation index, see [llms.txt](https://dev.solid-run.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.solid-run.com/amd/v3000/sbc-platform/bedrock-v3000-technical-documentation/software-bedrock-v3000/other-operating-systems-bedrock-v3000/installing-opnsense.md).

# Installing OPNsense

## Installing OPNsense

### Test setup

The installation was validated at SolidRun using the following setup:

* OPNSENSE 23.7
* Terminal software:
  * Putty
  * Alternatively, Tio can also be used.\
    **known TIO limitation**: in BIOS, the currently selected option is displayed in the same color as the background, which makes it not visible, yet it is still fully functional.
* USB flash disk: Kingston Data Traveler

## Installation process

### Creating bootable USB drive

Please follow instructions at [Creating bootable USB drive](/amd/v3000/sbc-platform/bedrock-v3000-technical-documentation/software-bedrock-v3000/creating-bootable-usb-drive-for-bedrock-v3000.md)

### Connecting serial console

Please follow instructions at [Using serial console with Bedrock V3000](/amd/v3000/sbc-platform/bedrock-v3000-technical-documentation/software-bedrock-v3000/using-serial-console-with-bedrock.md)

### BIOS settings

* Insert the USB media to the device
* Turn on Bedrock
* Repetitively press the DEL / ESC key to enter the BIOS setup
* In BIOS go to -> Save & Exit -> -> yes
* Device will reset and a PFsense boot screen will appear

### After boot

![](/files/cwx3Np2qK8lutsbINSRs)

* When you see the main boot menu:
* Press "esc" or the arrow buttons to go to the boot option shell
* Set the console redirection (copy to the terminal):
  * `set hw.uart.console="mm:0xfedc9000,rs:2"`
    * NOTE: the line you paste might look a little weird especially if you type it manually\
      example for copy: /K |et hw\.uart.console="mm:0xfedc9000,rs:2"\
      example for manual typing: \e|/-\\|/r-\co|sol/-\\|m:/x-ed\9|0/-\\|:/"\
      **THIS IS FINE AS LONG AS THE ACTUAL INPUT TEXT IS CORRECT**
  * Type `boot`
* After the system has booted you are prompted with a login
  * To use it as a live system you can login as:
    * Username: root
    * Password: opnsense
  * To install OPNsense login as:
    * Username: installer
    * Password: opnsense
    * From here on, I will reffer to the installer option:

![](/files/ut2f2VZ7MW5UGLEDggSk)

* Choose keymap
* Choose Partition scheme to be installed\\

![](/files/lS83vG1zHm8MRaUKyqEl)

Select UFS GPT/UEFI Hybrid

* Choose disk

![](/files/6IULBDZ1WfswLKGGWybx)

* Decide about swap partition

![](/files/9Xcv3v6GHEzByyxkQyjP)

* Confirm disk wipe
* Wait untill installation is complete

![](/files/bjZ6zRwEIjytHkfL9Moj)

### After installation

* You will be prompted to change the root users password, change it
* Log in to the root user login and go into a shell
* Create a /boot/loader.conf.local file which will contain our pernmanent console enable, and add:
  * hw\.uart.console="mm:0xfedc9000,rs:2"
  * console="efi"
  * Note: /boot/loader.conf recreates itself each boot or update, so this will override the changes.


---

# 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://dev.solid-run.com/amd/v3000/sbc-platform/bedrock-v3000-technical-documentation/software-bedrock-v3000/other-operating-systems-bedrock-v3000/installing-opnsense.md?ask=<question>
```

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.