# Using an external USB wifi adapter on BlueOS

**URL:** https://discuss.bluerobotics.com/t/using-an-external-usb-wifi-adapter-on-blueos/16931
**Category:** BlueOS
**Created:** [May 23, 2024, 7:09pm UTC](https://discuss.bluerobotics.com/t/using-an-external-usb-wifi-adapter-on-blueos/16931 "2024-05-23T19:09:48Z")
**Posts on this page:** 6
**Page:** 1

<div class="post-metadata">

### Author: ![dev](https://avatars.discourse-cdn.com/v4/letter/d/e8c25b/32.png) [@dev](https://discuss.bluerobotics.com/u/dev)
#### Post date: [May 23, 2024, 7:09pm UTC](https://discuss.bluerobotics.com/t/using-an-external-usb-wifi-adapter-on-blueos/16931/1 "2024-05-23T19:09:48Z")

</div>

Hello,  
I’m using BlueOS in boat mode. I have a requirement to use a USB WiFi adapter (versus an external WiFi router/AP). The USB adapter is recognized by the PI as uap0, but I can’t see a straight forward way of configuring its ssid and IP within BlueOS.

Is there a way to do this that doesn’t involve breaking something in BlueOS?

I’d prefer to use the USB adapter versus an external Wifi Ethernet adapter/router for power and size reasons.

Thanks!

---

<div class="post-metadata">

### Author: ![tony-white](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.bluerobotics.com/tony-white/32/13297_2.png) [@tony-white](https://discuss.bluerobotics.com/u/tony-white)
#### Post date: [May 24, 2024, 4:05am UTC](https://discuss.bluerobotics.com/t/using-an-external-usb-wifi-adapter-on-blueos/16931/2 "2024-05-24T04:05:00Z")

</div>

Hi @dev -  
Is there a reason you can’t use the WiFi radio that’s built into the Raspberry Pi? You should be able to connect to WiFi networks from the WiFi icon in the upper right without any additional hardware required.  
What USB WiFi adapter are you trying to use, can you share the specific model? It may not be supported in linux by default…

---

<div class="post-metadata">

### Author: ![dev](https://avatars.discourse-cdn.com/v4/letter/d/e8c25b/32.png) [@dev](https://discuss.bluerobotics.com/u/dev)
#### Post date: [May 24, 2024, 6:24am UTC](https://discuss.bluerobotics.com/t/using-an-external-usb-wifi-adapter-on-blueos/16931/3 "2024-05-24T06:24:13Z")

</div>

Hi Tony,

The RPI internal wifi doesn’t support external antennas which I need for added range during operation. The USB wifi adapter model seems to be supported by linux as the interface comes up and can be seen when running a ifconfig or an iwconfig, but shows as down since I can’t configure the SSID, etc. I realize I could probably configure it directly in the RPI, but this would likely break BlueOS, or at least require changes when upgrading etc. The model is a Alfa AWuS036ACH.

I thought I might be missing something easy to make this work, but if this isn’t the case, I’ll look at adding a dedicated wifi AP/router and interface with Ethernet to the RPI, as it may make more sense for future.

---

<div class="post-metadata">

### Author: ![rafael.lehmkuhl](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.bluerobotics.com/rafael.lehmkuhl/32/6630_2.png) [@rafael.lehmkuhl](https://discuss.bluerobotics.com/u/rafael.lehmkuhl)
#### Post date: [May 27, 2024, 5:11pm UTC](https://discuss.bluerobotics.com/t/using-an-external-usb-wifi-adapter-on-blueos/16931/4 "2024-05-27T17:11:42Z")

</div>

Hey @dev!

BlueOS uses `wpa_supplicant` to manage the wifi, and is hardcoded to the `wlan0` interface.  
What you can do to try to make it work is to rename the internal interface (`wlan0` to something else), rename your external adapter to be the `wlan0` and enable (“up”) it. You should do all of it while connected through a wired interface. Below I assume your external adapter is called `wlan1`:

- `ip link set wlan0 name wlan-internal`
- `ip link set wlan1 name wlan0`
- `ip link set wlan0 up`

If this works, you would need to create a UDEV rule to make this permanent.

---

<div class="post-metadata">

### Author: ![rafael.lehmkuhl](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.bluerobotics.com/rafael.lehmkuhl/32/6630_2.png) [@rafael.lehmkuhl](https://discuss.bluerobotics.com/u/rafael.lehmkuhl)
#### Post date: [May 29, 2024, 2:32pm UTC](https://discuss.bluerobotics.com/t/using-an-external-usb-wifi-adapter-on-blueos/16931/5 "2024-05-29T14:32:47Z")

</div>

I forgot to mention, but changing the wifi interface (also for a separate hotspot interface) is definitely something we want to support with a human-friendly UI in the future. My previous comment is just on the path of finding a workaround while we don’t support this.

---

<div class="post-metadata">

### Author: ![dev](https://avatars.discourse-cdn.com/v4/letter/d/e8c25b/32.png) [@dev](https://discuss.bluerobotics.com/u/dev)
#### Post date: [May 29, 2024, 3:48pm UTC](https://discuss.bluerobotics.com/t/using-an-external-usb-wifi-adapter-on-blueos/16931/6 "2024-05-29T15:48:17Z")

</div>

Hi @rafael.lehmkuhl

Thanks for the instructions and the update. I want to try to minimize the amount of one-off customization I’m doing to the system, so I have elected to use an external hotpot for now. It will also allow for additional Ethernet based devices. However, it is very good to know that this will be looked at in the future as an alternative.
