# 2026-05-22-instance-proxy
dir: 2026-05-22-instance-proxy

index: 2026-05-22-instance-proxy/.pi-map.index.md

## role
Provides an authenticated HTTP/WebSocket proxy layer to expose internal Docker containerized tool instances to users through a single API endpoint, replacing broken localhost links.
## files
- .openspec.yaml | Defines an OpenAPI specification configuration file with schema type and creation date metadata
- design.md | Design document for implementing a FastAPI-based HTTP/WebSocket proxy to allow users to access internal Docker tool instances through a single authenticated API endpoint. | dep: FastAPI, httpx, starlette.websockets, Docker
- proposal.md | Proposes adding an HTTP/WebSocket proxy endpoint to expose Docker containerized tool instances to users over HTTPS instead of broken localhost links | dep: docker, backend API, frontend, WebSocket, HTTPS
- tasks.md | Project task tracking checklist for implementing a proxy endpoint system that routes HTTP/WebSocket traffic to Docker container instances | dep: Docker, FastAPI/httpx, WebSocket, code-server, ruff, mypy
## arch
FastAPI-based reverse proxy architecture with WebSocket support, using OpenAPI-specified endpoints for authenticated traffic routing to dynamic Docker container instances.
## tags
docker, websocket, design, fastapi, http, proxy, instances, endpoint
## symbols
-
## workflows
-
## dirty
-