Web Interface (Docker)

The front-end is a React + Vite single-page app, shipped as a Docker image so it can be deployed on a Linux host independently of the Windows API server.

Configuration

Copy and edit the environment file:

cd PSWinDeploy/Web
cp .env.example .env

Edit .env:

VITE_API_URL=http://192.168.1.10:8080

Replace 192.168.1.10 with the IP address or DNS name of the Windows server hosting the API.

Running with Docker Compose

# From the project root
docker-compose up -d

# Check the container is running
docker-compose ps

# Follow the logs
docker-compose logs -f pswindeploy-web

The interface is reachable at http://DOCKER-HOST-IP:3000.

Pages available

Page	Purpose
Deploy	Pick a profile, select optional apps, launch preparation
Deployment	Live steps + streaming console logs for a running deployment
Catalogue	Browse/filter available apps and scripts by category
Profiles	Manage deployment profiles
Sequences	Drag-and-drop sequence editor
Logs	Deployment history
Settings	API endpoint, connection status

The API connection indicator (green / orange / red) reflects reachability; if the API can't be reached, the UI falls back to an offline demo mode.

Local development

cd Web
npm install
npm run dev

Deploying to a remote Linux server

# Copy the Web folder to the Linux server
scp -r ./Web user@linux-server:/opt/pswindeploy/

# On the Linux server
echo 'VITE_API_URL=http://windows-server:8080' > /opt/pswindeploy/.env
docker-compose up -d

Then open http://LINUX-SERVER-IP:3000 from any browser on the network.