Octa2Go Setup Instructions

Octa2Go Setup Instructions

Your Octa2Go comes with WLED pre-installed and ready to use. These instructions walk you through first-time setup, safe power wiring, LED configuration, and connecting to your network. If you ever need to re-flash the firmware, download links are provided at the bottom of this page.

Need to re-flash your firmware? The easiest way is our Web Flasher — it works directly in Chrome or Edge with no software to install (serial drivers still required). Manual download links are available at the bottom of this page if preferred.
1 Configure the Correct Voltage

The Octa2Go supports 5V, 12V, or 24V pixels. Before connecting anything, ensure the voltage jumper on the board is set to match your power supply and the pixels attached to ports 1–4.

Octa2Go voltage jumper
Critical: Selecting the incorrect voltage can damage your Octa2Go controller and/or your LEDs. Always verify this setting before applying power.
2 Connect Your Power Supply

Connect the voltage and ground lines from your DC power supply to P1. The Voltage (V+) connects to the 5V–24V terminal and Ground (V-) connects to the GND terminal.

P1 powers the ESP32, expansion header, and ports 1–4. The voltage on P1 must match the pixels attached to ports 1–4.

You may connect the same or a different power supply to P2. P2 powers ports 5–8 only. There is no voltage jumper setting for P2, but the voltage on P2 must match the pixels attached to ports 5–8.

Octa2Go wiring diagram
Reverse polarity protection: If you see a red LED lit on the controller above P1, you have connected the DC cable backwards. Disconnect power immediately and wait for the red LED to go out before reconnecting with correct polarity.

The reverse-protection circuit protects the controller only — any LEDs connected at the time may still be damaged. Always power on without pixels first to verify correct polarity.
Note: There is no reverse-voltage detection for P2. Double-check P2 polarity before powering ports 5–8.

Once connected correctly, the red LED on the ESP32 will light and the controller will begin booting WLED.

3 Connect Your Pixels

Remove the green male Phoenix connectors from the output ports. Insert the wires from your pixel strand into a connector, ensuring that Voltage (V), Data (D), and Ground (G) match the wiring diagram above.

Tip: The Octa2Go has eight pixel outputs. Ports 1–4 are powered by P1 and ports 5–8 are powered by P2. Match each pixel strand’s voltage to the power input feeding that group of ports.
4 Connect to WLED for the First Time

On your phone or computer, open WiFi settings and look for a network named WLED-AP-Octa2Go. Connect to it — if prompted for a password, enter wled1234.

WiFi network list showing WLED-AP-Octa2Go

A browser window should open automatically with the WLED welcome screen. If it does not, open your browser and navigate to http://4.3.2.1

WLED welcome screen
5 Set Your Current Limit

Setting a current limit prevents the controller from drawing more power than it can safely handle. Navigate to Config → LED & Hardware (called LED Preferences in versions older than 0.16).

Set Maximum PSU Current to 40000 mA (5A × 8 outputs). Then check the box labeled "Use per-output limiter" — this distributes the 40000mA evenly across all eight outputs, capping each at 5000mA.

Maximum PSU current setting in WLED Per-output current limiter setting in WLED
Screenshot note: The screenshots show the WLED settings screen layout. For Octa2Go, type 40000 mA for the Maximum PSU Current value.

Finally, set mA/LED to 30mA (typ, 12V) if you are using 12V bullet pixels. This improves WLED's current estimation accuracy.

6 Connect to Your Network

Navigate to Config → WiFi Setup and enter your network SSID and password. Click Save & Connect, then wait a few seconds and refresh the page.

WLED WiFi setup screen

Once connected, your assigned IP address will appear above the Configure Access Point section. You can then access the Octa2Go directly via your browser by entering this IP in the URL bar.

Client IP shown in WLED WiFi settings
Avoid special characters in your SSID. Spaces, apostrophes, and other special characters can prevent WLED from connecting. Rename your network temporarily if needed.
Static IP: If you need a fixed IP, populate the IP Address, Gateway, and Subnet Mask fields — a Gateway is required even if you don't use one. Alternatively, set an IP reservation in your router so it always assigns the same address without changing WLED settings.
7 Install the WLED App (Optional)

The WLED mobile app makes it easy to discover and control your controller without needing to know its IP address. Tap + then Discover Lights to find your Octa2Go automatically.

Apple (iOS) WLED Native →
The original WLED app is no longer on the App Store. Use WLED Native instead.
8 Configure LED Count and Color Order

By default, the Octa2Go is configured for 100 pixels on each of its eight outputs. When first powered on with pixels connected, they will display an amber/orange color — this is normal.

Pixels displaying orange on first boot

Most bullet pixels use an RGB color order, which is the default. If your colors don't display correctly, identify the correct color order using the method below.

  1. Set your lights to Red in WLED. Note the color that actually appears on the pixels.
  2. Set to Green. Note the color.
  3. Set to Blue. Note the color.
  4. The first letters of the three observed colors form your correct color order (e.g. Blue, Green, Red = BGR).
Color order identification example

Navigate to Config → LED Preferences → Hardware Setup → LED Outputs → Color Order and update the setting for each output. Click Save when done.

Color order setting in WLED
Firmware Downloads (if needed)

Your Octa2Go comes with firmware pre-installed. If you ever need to re-flash, use our Web Flasher for the easiest experience, or download the files below for manual flashing.

Firmware
Serial Drivers
ESPHome Flasher
Manual flashing instructions: See our Firmware Flashing Guide for step-by-step instructions.
🎉
Your Octa2Go is configured and ready to go!
Explore WLED's effects, palettes, and segments to bring your display to life. Questions? Contact us at jason@rgb2go.com.