What Is the Default Port for the Wand-Enhancer Remote Web Panel?

The Wand-Enhancer Remote Web Panel listens on port 3223 by default.

The k1tbyte/Wand-Enhancer repository provides a remote web panel for managing enhancement operations. Understanding the default port for the Wand-Enhancer Remote Web Panel is essential for configuring firewalls, connecting clients, and troubleshooting connectivity issues.

Where the Default Port Is Defined

The value 3223 is hardcoded as the canonical default across the protocol contract, bridge constants, and documentation.

Protocol Contract Configuration

In web-panel/protocol/web-contract.json, the default remote port is explicitly defined at line 6:

{
  "defaultRemotePort": 3223
}

This JSON contract serves as the single source of truth for the protocol specification.

Bridge Constants Implementation

The bridge module imports this contract and exposes it as a runtime constant. In web-panel/bridge/src/constants.ts, line 29, the DEFAULT_REMOTE_PORT constant is derived directly from the contract values for use throughout the application.

Documentation References

The high-level documentation in AGENTS.md confirms this configuration, explicitly mentioning that the default local remote port is 3223.

How to Use the Default Port in Your Code

When building clients or automation scripts, reference the port consistently through the provided constants or hardcoded values.

Reading from bridge constants:

import { DEFAULT_REMOTE_PORT } from './constants';
console.log(`Remote panel default port: ${DEFAULT_REMOTE_PORT}`);
// → Remote panel default port: 3223

Connecting via WebSocket:

const host = 'localhost';
const port = 3223; // default
const wsUrl = `ws://${host}:${port}/remote/ws`;
const socket = new WebSocket(wsUrl);

Changing the Default Port

While 3223 is the default, you can override it using environment variables when launching the bridge service:

export REMOTE_PORT=8080
pnpm run start:bridge

The bridge code reads process.env.REMOTE_PORT to dynamically adjust the binding address, falling back to the DEFAULT_REMOTE_PORT constant if the environment variable is unset.

Summary

Frequently Asked Questions

What is the default port for the Wand-Enhancer Remote Web Panel?

The default port is 3223. This port is used for all remote web panel connections unless explicitly configured otherwise through environment variables.

Can I change the default port from 3223 to something else?

Yes. Set the REMOTE_PORT environment variable before starting the bridge service. The application will bind to your specified port instead of 3223, allowing you to avoid conflicts with existing services.

Where is the default port defined in the source code?

The canonical definition resides in web-panel/protocol/web-contract.json under the defaultRemotePort key. This value propagates to web-panel/bridge/src/constants.ts where it is exported as DEFAULT_REMOTE_PORT for runtime consumption.

Does the default port support WebSocket connections?

Yes. Port 3223 serves WebSocket endpoints for real-time communication. Clients connect using URLs formatted as ws://localhost:3223/remote/ws to interact with the remote panel interface according to the protocol contract.

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →