v1.5.6 — Dark Premium redesign

• Complete UI overhaul — Dark Premium design language (Linear / Vercel aesthetic)
• New design system: Inter + JetBrains Mono, layered dark backgrounds, accent-driven colour system
• Sidebar with Lucide React icons and proper active/hover states
• Stat cards on dashboard (Total, Running, Stopped, Images) with skeleton loading
• Login page redesigned: centred card with radial accent glow, fadeSlideUp animation
• Shared component library: Button, Badge, Card, Input, EmptyState, Skeleton
• Watcher integration — updates widget on dashboard showing pending image updates
• One-click update and rollback from NEXUS UI

v1.5.4 - Agent install script & non-root container

What's new

• Agent install script — wizard step 3 now downloads a ready-to-run bash script instead of showing a compose file to copy
  • Script creates docker-compose.yml (with ${NEXUS_URL} / ${NEXUS_AGENT_TOKEN} placeholders) and a .env file with the real credentials baked in, then runs docker compose up -d and tails the logs so you can confirm the agent connects before pressing Ctrl+C
  • Download works via a pre-rendered <a download> with a data URI computed synchronously at render time — no async onClick that could block the browser
• Non-root agent container — agent/Dockerfile now creates user nexus, adds it to the docker group (GID 999) and runs the process as that user
• Version bump to 1.5.4 in Login, Settings About panel, /api/health endpoint and README

v1.5.3 — Simplified Multi-host Setup

✨ What’s new

NEXUS Agent — now easier than ever to deploy and connect

In v1.5.2, we introduced the new NEXUS Agent architecture to solve cross-platform connectivity issues and remove the need for direct Docker socket exposure.

However, the setup process still required:

Manual .env configuration
Manual token insertion
Some understanding of deployment details

In v1.5.3, we focused on simplifying this entire process and making multi-host setup fully guided and frictionless.

🧠 What changed

Instead of manually configuring the agent, NEXUS now provides a fully guided host onboarding experience.

How it works now:
You add a host directly from the UI (Settings → Hosts → Add remote host)
NEXUS generates:
A secure token
A ready-to-use docker-compose.yml
You simply run it on the target machine
The agent connects automatically to NEXUS

⚙️ New workflow
Setup in 2 steps
Add a host in NEXUS:
Go to Settings → Hosts
Click + Add remote host
Choose name + OS
Generate token
Run the agent on the remote machine:
docker compose up -d

That’s it — the host appears automatically in the server selector.

🔥 Improvements over v1.5.2
Why this is better:
✅ No manual .env files
✅ No copy/paste of tokens into configs
✅ No port forwarding or firewall rules
✅ Fully guided setup from the UI
✅ Faster onboarding (seconds instead of minutes)
✅ Reduced user error

🖥️ Platform support
✅ Works on Windows, Linux, and macOS
✅ Supports Docker Desktop environments (including WSL2)
✅ OS-aware setup (better guidance depending on system)

🎨 UI & UX improvements
Added host wizard
Added OS selection
Added OS logos/icons
Improved host selector in dashboard

🧹 Internal changes
Removed legacy agent setup:
.env.example
Old manual docker-compose.yml
Backend updated for token + host provisioning
Frontend updated with new onboarding flow

🔐 Architecture (unchanged, but improved UX)
Agent still connects outbound via WebSocket
No inbound ports required
Token-based authentication
Docker socket remains local to the host

⚠️ Notes

Windows (Docker Desktop):
Enable:

Expose daemon on tcp://localhost:2375 without TLS

🏁 Summary

v1.5.3 takes the solid foundation of v1.5.2 and makes it significantly easier to use:

Less configuration
Better UX
Faster deployment
Same secure architecture

v1.5.2 — Universal Multi-host Support

🚀 What's new

NEXUS Agent — the right way to do multi-host

Previous versions of NEXUS supported multi-host via a direct TCP connection to a docker-socket-proxy running on the remote machine. This worked well on Linux, but broke on Windows with Docker Desktop — because containers inside Docker Desktop's WSL2 VM cannot reach the host's LAN directly, regardless of configuration.

Rather than working around a Docker Desktop networking limitation, we rebuilt multi-host from the ground up with NEXUS Agent.

How it works:

• A lightweight container (afraguas1983/nexus-agent:latest) runs on the remote machine
• The agent connects outbound to NEXUS via WebSocket — no open ports required on the client
• NEXUS sends Docker commands to the agent, which executes them locally and returns the results
• The connection is authenticated with a token generated from NEXUS Settings

Why this is better:

• ✅ Works on Windows, Linux, and macOS — with or without Docker Desktop
• ✅ No firewall rules or port forwarding needed
• ✅ Token-based authentication — each agent has its own revocable token
• ✅ Auto-reconnect — if NEXUS or the agent restarts, the connection resumes automatically
• ✅ More secure — the Docker socket never leaves the client machine

Setup in 2 steps

1. Generate a token in NEXUS Settings → Hosts

2. Run the agent on the remote machine:

Linux / macOS:

services:
  nexus-agent:
    image: afraguas1983/nexus-agent:latest
    container_name: nexus-agent
    restart: unless-stopped
    environment:
      - NEXUS_URL=http://YOUR_NEXUS_IP:9090
      - NEXUS_AGENT_TOKEN=YOUR_TOKEN
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

Windows (Docker Desktop):

services:
  nexus-agent:
    image: afraguas1983/nexus-agent:latest
    container_name: nexus-agent
    restart: unless-stopped
    environment:
      - NEXUS_URL=http://YOUR_NEXUS_IP:9090
      - NEXUS_AGENT_TOKEN=YOUR_TOKEN
      - DOCKER_HOST=tcp://host.docker.internal:2375
    extra_hosts:
      - "host.docker.internal:host-gateway"

UI improvements

• Login card redesigned — now consistent with NEXUS Watcher and NEXUS Hub
• Sidebar logo updated — SVG direct, no wrapper square
• i18n: added login.title key (Container Platform) in EN and ES

---

📦 Docker Hub

docker pull afraguas1983/nexus:latest
docker pull afraguas1983/nexus-agent:latest

---

🔧 Breaking changes

None. The existing TCP multi-host setup still works on Linux. The agent is an addition, not a replacement.

v1.5.1 — Vite migration & CVE fixes

🔧 Maintenance & Security

⚡ Vite Migration

• Migrated frontend build tool from react-scripts to Vite
• Build time reduced from ~100s to ~50s
• Eliminated CVEs introduced by react-scripts dependencies

🔒 Security fixes

• Upgraded base Docker image from node:16-alpine to node:20-alpine in build stage
• Added apk upgrade in both build stages to fix alpine CVEs (busybox, zlib)
• Renamed all .js frontend files to .jsx for proper Vite compatibility

🐳 Update
docker compose pull && docker compose up -d

v1.5.0 — Network & Volume management is here

🌐 Network & Volume Management

🌐 Networks

• List all Docker networks with driver, scope, subnet and gateway info
• Create networks (bridge, overlay, macvlan) with optional subnet/gateway
• Delete networks (system networks bridge, host, none are protected)
• Full inspect modal with raw JSON

💾 Volumes

• List all Docker volumes with driver, mountpoint and creation date
• Create volumes with custom driver (local, nfs, tmpfs)
• Delete volumes with confirmation dialog
• Full inspect modal with raw JSON

🌍 Improvements

• Both views support multi-host
• Full EN/ES translations for all new views
• Version bump to v1.5.0 across all components

🐳 Update

docker compose pull && docker compose up -d

v1.4.1 — Visual refresh & fixes

🎨 Visual Refresh & Fixes

🟢 New Branding

• New green logo replacing the previous blue design
• Updated login screen, sidebar, favicon and PWA icon
• Consistent branding across all surfaces

📸 Screenshots

• All screenshots updated with new branding
• Added Images view screenshot

🌍 Improvements

• Added Images translation (EN/ES) in navigation menu
• Published to Docker Hub: docker pull afraguas1983/nexus:latest

v1.4.0 — Image Management

🖼 Image Management

📋 Image List

• List all local images with size, tag and creation date
• Sortable and filterable image table
• Click any image to expand full details

🔍 Image Details

• View architecture, OS, layers, entrypoint and exposed ports
• Full environment variables inspector
• Raw image metadata

🐳 Docker Hub Integration

• Search Docker Hub directly from the panel
• Pull any image with one click
• Direct pull by name (e.g. nginx:latest, postgres:16)

🗑 Image Cleanup

• Remove local images directly from the UI
• Force remove option available

🔧 Fixes

• Fix: missing services: key in remote host docker-compose snippet

v1.3.0 — Container Management

🚀 What's New

🐳 Container Management

• New guided form to create containers from the UI (5 steps: Image → Config → Storage → Network → Review)
• Automatic image pull before container creation
• Port mappings, environment variables, volumes and restart policy configuration
• Network selection (bridge, host, none or custom)

📄 Stack Management

• Deploy docker-compose stacks directly from the UI
• Built-in YAML editor with syntax highlighting and line numbers
• Preview mode to review the compose file before deploying
• Edit and redeploy existing stacks
• Start, stop and restart stacks
• Delete stacks (stops and removes all containers)

🗑️ Delete Containers

• New delete button for stopped containers in the compact table
• Confirmation dialog before deletion

🎨 UI Improvements

• Minimalist icons for Events and Deploy in the sidebar
• New MANAGE section in the sidebar (admin only)

v1.2.0 — Internationalization

🌍 What's New

🗣️ Multi-language Support

• English and Spanish available
• Language selector on Login screen
• Language selector in Settings → System
• Language preference saved automatically
• All UI elements translated