How to use dsh web: open it, tour the UI, install plugins

Install & Get StartedPublished 2026-08-28Author: DSH Plugin Hub
DeepSeek HarnessDSH plugindsh webweb UIusage guide
dsh web is the DeepSeek Harness UI: three ways to open it, a tour of areas (settings, chat, Plugin Center, logs), configuring models and installing plugins.

dsh web is the DeepSeek Harness web UI: start the service and open http://127.0.0.1:3080 in the browser. This guide covers three ways to open it, a tour of the main areas (settings, chat, Plugin Center, logs), and the common workflows for configuring a model and installing plugins — closing with a troubleshooting table.

Overview: what dsh web is

dsh web is a locally running web app — no desktop client to install, just a browser. Once started, everything happens in one interface (source). The four core areas at a glance:

AreaWhat it doesWhen to use it
Settingsmodel, provider and key configfirst run, switching models
Chat windowtalk to models, manage historydaily use
Plugin Centerbrowse, install, manage pluginsinstalling plugins
Logs and diagnosticsreview activity, troubleshootwhen something fails

Three ways to open dsh web

Start by command, keep the service running, or visit directly — pick whichever fits. Three ways:

Way 1: start with npx (no install)

  1. Prerequisite: Node.js on the machine; node -v prints a version;
  2. Open a terminal and run:
bash
npx @deepseek-ai/dsh web
  1. The first run downloads the package and initializes the web profile; wait for the "service started" message;
  2. The browser opens http://127.0.0.1:3080 automatically; finish the first-time setup.

Way 2: start after a global install

  1. Prerequisite: npm install -g @deepseek-ai/dsh has been run before;
  2. Run dsh web in the terminal;
  3. The browser opens http://127.0.0.1:3080.

Way 3: visit directly when the service is already running

  1. Prerequisite: the dsh web service is running in some terminal (started by either way);
  2. Type http://127.0.0.1:3080 in any browser address bar and press Enter.

Fallback: dsh: command not found means there is no global install — switch to Way 1. If the address won't open, confirm the terminal service is still running (closing the terminal window stops the service).

Tour of the main areas: settings, chat, Plugin Center, logs

Think of the interface as configure → use → extend → troubleshoot. Tour:

  1. Settings: configure model providers and API keys — the first stop on a fresh install; port and proxy options live here too;
  2. Chat window: talk to models and manage session history — the daily workspace;
  3. Plugin Center: appears after installing DSH Plugin Hub and restarting; browse, install, update and uninstall plugins from here;
  4. System logs and diagnostics: review install/update/uninstall trails and run diagnostics for troubleshooting.
dsh-plugin-hub · installed
DSH Plugin Hub installed plugin list

Common workflows: configure a model, install plugins, read logs

Three high-frequency operations, learned once. Steps:

Workflow 1: configure a model (change settings)

  1. Open Settings → model config;
  2. Choose a provider, fill in the endpoint and key (e.g. an OpenAI-compatible API);
  3. Click Save; the interface confirms;
  4. Return to the chat window, pick the model you just configured and start talking.

Workflow 2: install a plugin

  1. Add the market entry from the command line: dsh plugin --profile web add dsh-plugin;
  2. Restart dsh web and refresh the page;
  3. Open Settings → Plugin Center and search or browse to the target plugin;
  4. Click Install on its card, review the plugin name and source in the confirmation dialog, then confirm;
  5. When the live progress finishes, refresh the page — the plugin is active.

Workflow 3: read the logs

  1. Open Settings → System logs;
  2. Filter by category (install, update, uninstall, runtime) and level;
  3. Locate the relevant record and copy the full error text for troubleshooting.

Troubleshooting common issues

Can't open it, changes don't apply, errors thrown — locate the problem in the table first. Common issues:

IssueLikely causeFix
Port 3080 won't open in the browserservice not running or already exitedgo back to the terminal and confirm the service is up; closing the window stops it
dsh: command not foundno global installuse npx @deepseek-ai/dsh web, or run npm install -g @deepseek-ai/dsh first
Plugin Center missing from the UIDSH Plugin Hub not installed, or not restarteddsh plugin --profile web add dsh-plugin, then restart dsh web
Plugin not active after installpage not refreshed, or wrong profilerefresh the page; make sure the command used --profile web
Chat messages error outmodel not configured, or wrong keycheck the endpoint and key in Settings → model config, save, retry
Setting changes don't applynot saved, or a restart is requiredclick Save; some settings only take effect after restarting dsh web

Quick recap

In short: the web UI is the gateway — configure models in Settings, install plugins in the Plugin Center, check logs when something fails, and confirm the service is running if the page won't open. Four reminders:

  1. Configure a model first — without a provider configured, the chat window cannot work;
  2. Restart and refresh after installing plugins — restart dsh web and refresh after any install or uninstall to make sure it takes effect;
  3. Logs keep records — every install, update and uninstall is written to the system logs; read the logs first when something goes wrong;
  4. Keep the terminal open — the dsh web service runs in the terminal; closing the window stops it.

Sources: DeepSeek Harness docs - Quickstart, dsh CLI README, dshplugin/dsh-plugin-hub

FAQ

What is dsh web?

dsh web is the DeepSeek Harness web UI, a locally running web app. After the service starts, open http://127.0.0.1:3080 in the browser — it is the main interface for dsh, hosting settings, chats, the Plugin Center and logs in one place.

How do I open dsh web?

Three ways: run npx @deepseek-ai/dsh web without a global install; run dsh web after npm install -g @deepseek-ai/dsh; or, if the service is already running, type http://127.0.0.1:3080 in any browser. Keep the terminal window open — closing it stops the service.

What are the main areas of the dsh web interface?

Four core areas: Settings (model providers and API keys), the chat window (conversations and history), the Plugin Center (install and manage plugins, appears after installing DSH Plugin Hub and restarting), and system logs plus diagnostics for troubleshooting.

How do I configure a model in dsh web?

Open Settings → model config, pick a provider, fill in the endpoint and key (for example an OpenAI-compatible API), save, and the model becomes available in the chat window. Per-provider details are in the official docs.

How do I install a plugin in dsh web?

First add the market entry from the command line with dsh plugin --profile web add dsh-plugin, restart dsh web, then go to Settings → Plugin Center → search → Install → confirm. Alternatively install any plugin directly with dsh plugin --profile web add <package>.

Sources