BitErr15

← Return to Bitcoin

---

Bitaxe Network Recovery and Config Guide

• Purpose

This procedure documents how to recover access to a Bitaxe after it has been moved to a new network, displays a Wi-Fi password error, or its IP address is unknown.

---

• Symptoms

Common symptoms include:

• Display shows **Incorrect Password (Err 15)**
• Bitaxe is not visible on the local network
• Unknown IP address
• Unable to access AxeOS
• Device broadcasts a setup access point such as:

``` Bitaxe_6749 ```

---

1. Connect to the Bitaxe Setup Access Point

If the Bitaxe cannot connect to the configured Wi-Fi network, it should create its own access point.

1. Open Wi-Fi settings on your laptop or phone. 2. Connect to:

``` Bitaxe_xxxx ```

3. Verify that your device receives an address in:

``` 192.168.4.x ```

4. Open a browser and navigate to:

``` http://192.168.4.1 ```

5. The AxeOS configuration page should appear.

---

1. Configure Wi-Fi

1. Enter the desired Wi-Fi network name (SSID). 2. Enter the Wi-Fi password carefully. 3. Verify that the network is a 2.4 GHz network if required. 4. Save the configuration. 5. Reboot the Bitaxe.

---

1. Find the New IP Address

After the Bitaxe joins the network, determine its new address.

1. 1. Router Client List

Check the router's connected device list.

Look for:

• Bitaxe
• ESP32
• Unknown device
• The Bitaxe MAC address

---

1. 1. ARP Table

Linux:

```bash arp -a ```

---

1. 1. Network Scan

Linux:

```bash nmap -sn 192.168.123.0/24 ```

Adjust the subnet as needed.

Example:

```bash nmap -sn 192.168.1.0/24 ```

---

1. 1. Custom Discovery Scripts

A custom script may be used to locate devices by:

• MAC address
• Hostname
• Open HTTP services

---

1. Verify Operation

Once connected:

1. Open AxeOS in a browser. 2. Verify pool connectivity. 3. Verify hash rate. 4. Verify share count is increasing. 5. Verify temperature and fan operation.

---

1. AxeOS API Examples

1. 1. Display Raw API Output

```bash curl -s "$BITAXE_URL/api/system/info" ```

---

1. 1. Pretty Print JSON

```bash curl -s "$BITAXE_URL/api/system/info" | jq . ```

---

1. 1. View Available Keys

```bash curl -s "$BITAXE_URL/api/system/info" | jq 'keys' ```

---

1. 1. Searchable Output Using less

```bash curl -s "$BITAXE_URL/api/system/info" | jq . | less ```

---

1. 1. Preserve jq Colors

```bash curl -s "$BITAXE_URL/api/system/info" | jq -C . | less -R ```

---

1. 1. Display a Specific Field

Example:

```bash curl -s "$BITAXE_URL/api/system/info" | jq -r '.hostname' ```

---

1. Useful less Commands

While viewing output in `less`:

| Key | Function | | ----- | -------------- | | /text | Search | | n | Next match | | N | Previous match | | g | Top of file | | G | Bottom of file | | q | Quit |

Example:

```text /wifi ```

Searches for "wifi".

---

1. Notes

• AxeOS v2.12.2 and later may return compact JSON rather than formatted JSON.
• `jq` is recommended for formatting and field extraction.
• Bitaxe devices are Wi-Fi only.
• 2.4 GHz Wi-Fi is generally recommended.
• Keeping the same SSID and password across locations simplifies relocation.
• Document the Bitaxe MAC address for easier future identification.

---

1. Example Environment

Example setup:

| Device | Address | | -------- | --------------- | | Bitaxe | DHCP Assigned | | Gateway | 192.168.123.1 | | Laptop | 192.168.123.240 | | Setup AP | 192.168.4.1 |

Adjust these values to match your own network.

---

1. Revision History

| Date | Notes | | ---------- | --------------- | | 2026-06-10 | Initial version |