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

> Discover the default port for the Wand-Enhancer Remote Web Panel. Learn how to access this feature on port 3223 for seamless remote management.

- Repository: [k1tbyte/Wand-Enhancer](https://github.com/k1tbyte/Wand-Enhancer)
- Tags: how-to-guide
- Published: 2026-09-01

---

**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`](https://github.com/k1tbyte/Wand-Enhancer/blob/main/web-panel/protocol/web-contract.json), the default remote port is explicitly defined at line 6:

```json
{
  "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`](https://github.com/k1tbyte/Wand-Enhancer/blob/main/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`](https://github.com/k1tbyte/Wand-Enhancer/blob/main/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:

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

```

Connecting via WebSocket:

```javascript
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:

```bash
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

- The default port for the Wand-Enhancer Remote Web Panel is **3223**.
- This value originates in [`web-panel/protocol/web-contract.json`](https://github.com/k1tbyte/Wand-Enhancer/blob/main/web-panel/protocol/web-contract.json) as `defaultRemotePort`.
- The bridge exposes it via `DEFAULT_REMOTE_PORT` in [`web-panel/bridge/src/constants.ts`](https://github.com/k1tbyte/Wand-Enhancer/blob/main/web-panel/bridge/src/constants.ts).
- You can override the default using the `REMOTE_PORT` environment variable before startup.

## 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`](https://github.com/k1tbyte/Wand-Enhancer/blob/main/web-panel/protocol/web-contract.json) under the `defaultRemotePort` key. This value propagates to [`web-panel/bridge/src/constants.ts`](https://github.com/k1tbyte/Wand-Enhancer/blob/main/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.