DeepSeekDSH
Independent community guideNot affiliated with DeepSeek.Download versions and guide references

Use DeepSeek Harness on Your Phone: Beginner Guide

Zero-jargon beginner guide to using DeepSeek Harness on your phone: find your computer IP, connect over home Wi-Fi in 2 minutes, or use Tailscale on 4G/5G.

Maintained by DeepSeekDSH (independent site)Documentation review
On this page
Editorial blueprint illustration of a desktop workstation connected across a shielded tunnel to a smartphone showing an approval check

If you searched the App Store or Google Play for DeepSeek Harness and only found the regular DeepSeek chat app, you did nothing wrong. Before installing anything, three plain facts explain how phone access actually works:

  1. There is no standalone DSH mobile app in app stores: The DeepSeek app in mobile stores is just regular cloud chat and cannot see the folders on your computer. DeepSeek Harness (DSH) itself runs on your computer.
  2. Think of your computer as the TV and your phone as the remote: Your computer runs DSH on your desk, while your phone browser opens its control screen. Starting in v0.2.2-rc.1, the official DSH web interface adapts cleanly to small phone screens so you can check progress, send instructions, and approve actions from the couch or train.
  3. You can also text DSH from a chat app: If you prefer messaging over opening a browser, community plugins let you talk to DSH through Telegram, Discord, Feishu, or WeChat.

One quick check before starting: Make sure Node.js (24.9+) and DSH already work on your computer. Brand new to DSH? Finish our 5-minute computer installation tutorial first, then come right back here.

Compare the 4 phone options: which one should a beginner pick?

You only need one of these four methods. Pick the row that matches where you want to use your phone:

Connection OptionSetup TimeWorks Away from Home (4G/5G)?Extra Apps Needed?Best For
Method 1: Home Wi-Fi browser link2 minutesNo (same home router only)None at allChecking your computer's progress from the couch or another room
Method 2: Tailscale private connection5 minutesYes (works anywhere on cellular)Free Tailscale app on computer + phoneCommuting, working from an office, or traveling away from home
Method 3: Telegram / Discord / Feishu / WeChat10 minutesYesCommunity chat plugin in DSHSending quick text checks without opening a phone browser
Method 4: Community mobile plugins / Android APK15 minutesVariesThird-party open-source add-onExperienced users comfortable reviewing third-party code

Best path for first-timers: Spend two minutes on Method 1 at home first so you see how DSH looks on your phone. Once that works, add Method 2 in five minutes if you want access outside the house.

Method 1: Connect at home over Wi-Fi (no extra apps, 2 minutes)

Normally, DSH locks its web page (127.0.0.1) so only your computer screen can open it. By telling DSH your computer's local home Wi-Fi address when starting up, your phone on the same router can open the page right away.

Step 1: Look up your computer's home Wi-Fi IP address (no commands needed)

First, check two things: your phone and computer must be connected to the exact same home Wi-Fi name, and if you have a VPN app turned on your computer, pause it for now.

Now find your computer's local Wi-Fi number right in system settings:

  • On Windows: Click Start -> Settings -> Network & internet -> Wi-Fi, click the Wi-Fi network you are connected to, and scroll down to IPv4 address. Write down that number starting with 192.168. or 10. (for example, 192.168.1.25).
  • On Mac: Click the Apple menu in the top-left corner -> System Settings -> Wi-Fi, click the Details... button next to your connected Wi-Fi, and copy the IP Address shown there (for example, 192.168.1.25).

(Prefer typing a command instead? Run ipconfig in Windows PowerShell, ipconfig getifaddr en0 in Mac Terminal, or hostname -I on Linux.)

Step 2: Open your computer's command window and start DSH

Open the built-in command window on your computer:

  • On Windows: Press the Win key on your keyboard, type PowerShell, and click the blue Windows PowerShell app.
  • On Mac: Hold Command + Space, type Terminal, and press Enter.

Copy the command below, replace 192.168.1.25 with the number you wrote down in Step 1, paste it into the window, and press Enter (full flag details are in the official DSH CLI guide):

npx @deepseek-ai/dsh web --host 192.168.1.25 --no-open

(If Windows pops up a Firewall prompt asking for permission, check Private networks and click Allow access.)

Wait a few seconds until the window prints a long web link ending with ?token=..., looking like this:

http://192.168.1.25:3080/?token=xxxx...

Important beginner rule: Keep this command window open on your computer! You can minimize it, yet clicking X to close the window immediately shuts down DSH and disconnects your phone.

Step 3: Send the ENTIRE long link to your phone and pin it to your home screen

Highlight and copy that entire link including the ?token=... ending, send it to your phone (via AirDrop, email to yourself, or a private note), and open it in Safari (iPhone) or Chrome (Android).

  • Do not type the short number by hand: Typing bare 192.168.1.25:3080 without the ?token=... passkey at the end will get blocked as unauthorized. Once you open the full link one time, your phone browser saves your login automatically.
  • Is the message box at the bottom grayed out? Tap Choose workspace on the screen to pick a folder on your computer, then pick a model from the model dropdown, and the message box will unlock right away.

Make it open full-screen like a real phone app:

  • iPhone (in Safari): Tap the Share button at the bottom center (square with an upward arrow), scroll down, and tap Add to Home Screen.
  • Android (in Chrome): Tap the three-dot menu in the top-right corner and tap Add to Home screen.

You now have a dedicated DSH icon right on your phone's home screen.

Safety rule: Only use this 192.168 method on your own private home Wi-Fi. Never run it on coffee shop, airport, or hotel Wi-Fi, and never share screenshots showing your ?token= link.

Method 2: Connect from anywhere on 4G/5G in 5 minutes (easy Tailscale setup)

As soon as you leave home and switch to mobile data, 192.168 addresses stop working. Do not mess with router port forwarding—it is complicated and unsafe for beginners.

Instead, use a free personal app called Tailscale. Think of Tailscale as an invisible, private encrypted cable connecting just your phone and your home computer so nobody else on the internet can see it.

Follow these three simple steps—no domain setup needed:

Step 1: Install Tailscale on your computer and phone, and sign in to the same account

  1. Download and install Tailscale on your computer from Tailscale's website, and install the Tailscale app from the App Store or Google Play on your phone.
  2. Sign in on both devices using the exact same Google, Microsoft, Apple, or GitHub login, and flip the switch to Connected (tap Allow if your phone asks to add a VPN configuration).

Step 2: Click the Tailscale icon on your computer to copy its 100. address

Look at the top-right menu bar on Mac or the bottom-right system tray on Windows and click the small Tailscale icon.

Next to your computer's name, you will see a number starting with 100. (such as 100.88.12.34). Click it to copy that address.

Step 3: Start DSH using that 100. address

Just like Method 1, open your computer's command window, replace 100.88.12.34 below with your own 100. number, and press Enter:

npx @deepseek-ai/dsh web --host 100.88.12.34 --no-open

Send the full printed http://100.88.12.34:3080/?token=... link to your phone and open it in Safari or Chrome. Because Tailscale encrypts everything between your two devices automatically, you can now turn off Wi-Fi on your phone and control your home DSH safely over 4G or 5G from anywhere!

(Optional note for advanced users: if you set up a custom .ts.net HTTPS domain via tailscale serve --bg 3080 or a reverse proxy instead of using the 100. IP directly, follow the official reverse-proxy security guide and add --public-url https://your-domain/ --trusted-host your-domain so DSH does not block domain requests with a 403 error.)

Check laptop sleep before leaving home: Closing a laptop lid puts your computer to sleep and cuts off your phone connection! Before heading out, plug your computer into wall power and set Put computer to sleep when plugged in to Never in your power settings.

Method 3: Text DSH from Telegram, Discord, Feishu, or WeChat

Do not feel like opening a mobile web page just to ask "Did the task finish?" You can link your computer's DSH to a chat app instead using our step-by-step guides:

Bonus tip: if you like jotting down ideas in the regular DeepSeek chat app on your phone while commuting, v0.2.2-rc.3 added an experimental DeepSeek Chat Import feature (deepseek-chat-import) that pulls your mobile chat history straight into DSH back on your computer.

Should beginners install third-party "DSH mobile" apps from GitHub?

While browsing forums or GitHub, you might run across community-built mobile add-ons such as dsh-pwa (Discussion #8004), dsh-mobile-remote (Discussion #2520), or the community Android client deepseek-harness-mobile.

Plain advice for beginners: All of those are unofficial hobby projects made by community members, not by the DeepSeek team. Stick with the official browser method above—it requires zero third-party installers and stays up to date automatically. If you ever test community plugins later on, review our plugin safety checklist first.

Troubleshooting table when your phone cannot connect

Match what you see on your screen to the quick fix on the right:

What HappenedWhy It HappenedQuick Fix
Computer says 'npx' is not recognized or command not foundNode.js is not installed on your computer yetInstall Node.js 24.9+ using our computer setup tutorial, reopen the command window, and try again
Phone browser spins and says This site can't be reachedCommand window was closed, wrong Wi-Fi, VPN is on, or firewall blocked itConfirm the computer command window is still open, pause computer VPNs, verify same Wi-Fi, or confirm Tailscale says Connected on both devices
Phone says Unauthorized or Access deniedYou typed the short IP number without the ?token=... passkeyCopy the entire ?token=... link from the computer window and open that full link once
Page loads its frame, then shows 403 errorsOpened via a domain name without telling DSH to trust that domainEither use the 100. Tailscale number above, or add --trusted-host your-domain (domain only, no https://)
Page opens fine, yet the chat input box is grayed outNo project folder or AI model is selected yetTap Choose workspace to pick a folder and choose a model from the dropdown

Common questions

Can I turn off my home computer and still run DSH on my phone?

No. Your computer does the actual file reading and coding work while your phone acts as the remote screen. If you want 24/7 phone access without leaving a laptop awake at home, you can rent an inexpensive $5/month Linux cloud server, run DSH there, and connect from your phone using Method 2 (Tailscale).

Any safety tips before tapping "Approve" on a small phone screen?

Long folder names and terminal commands get shortened with ... on narrow phone screens. Practice inside an empty dsh-test folder on your Desktop first, and always tap to expand the full file path before approving file changes or terminal commands while away from your desk.

How do I turn off phone access completely when I am finished?

Go back to the command window on your computer and press Ctrl + C (or simply close that command window). Phone access stops immediately.

Model and workflow guides

Models and costs

Gemini 4 Neon is here. When is it worth switching models?

Compare Gemini 4 Neon in two coding setups, work through a $0.45 API example, and find Neon in Gemini, Google AI Studio, and Antigravity.

Read →
Models and costs

GPT-6.2 Astra & Sol Guide: Specs, Pricing & Choice

Beginner guide to OpenAI's GPT-6.2 Astra and Sol: Claude vs DeepSeek price table, plain-English benchmarks, 272K cliff, and step-by-step DSH & Python setup.

Read →
Models and costs

GPT-6.1 Terra Guide: Uses, Pricing and Sol Comparison

Beginner guide to OpenAI's GPT-6.1 Terra: half-price visual, computer-use, and writing model compared with Sol and DeepSeek, plus DSH and Python setup steps.

Read →
Model setup and costs

Connect Local Qwen 3.8 27B to DSH

Beginner guide to connecting local Qwen 3.8 27B to DSH: GPU memory table, LM Studio / Ollama / llama.cpp port setup, exact 5-field config, and error fixes.

Read →
Model setup and costs

Codex Costs: API Billing vs Subscription Usage

Beginner guide to OpenAI Codex costs: ChatGPT Plus login vs API-key billing table, real per-prompt dollar math, and 3 steps to lock a monthly budget cap.

Read →
Model setup and costs

Connect Grok API to DSH: Setup & Tools

Step-by-step beginner guide to connecting xAI's Grok API (grok-4.7) to DSH: Grok vs Groq comparison, exact 5-field custom provider setup, and 401/404 fixes.

Read →
Model setup and costs

Choose a Gemini Model by Task and Cost

Beginner guide to Google Gemini model selection: compare 3.8 Flash, 4 Argon, and DeepSeek prices, watch 2027 rate changes, and set up DSH in 4 simple steps.

Read →
Model benchmarks and engineering

Gemini 4 Argon Coding Benchmarks & 1M Window

Beginner guide to Google's Gemini 4 Argon coding scores vs Claude and GPT, how its shared 1M window and 65K output cap work, plus 4-step DSH setup.

Read →
API costs and enterprise ROI

Gemini 4 Argon API Pricing, Cache & ROI Guide

Beginner guide to Gemini 4 Argon API pricing: Dec 2026 2x rate jump, how 95% auto-caching and thinking tokens bill, DeepSeek cost comparison, and calculator.

Read →
Model setup and costs

Claude Sonnet vs Opus: Which Should You Use?

Beginner guide to Claude Sonnet 5.5 vs Opus 5.5: side-by-side API prices, per-prompt cost math, clear rules on when to upgrade, and 4-step DSH setup.

Read →
Models and costs

Opus 5.5 vs Fable 5.2: Which Model Is Right for You?

Beginner guide to Claude Opus 5.5 vs Fable 5.2: side-by-side API prices, coding benchmarks, per-task cost math, 30-day retention rules, and 4-step DSH setup.

Read →
Content creation

How to draft a video script with Media Desk for DeepSeek Harness

Turn a phone note into a video script, cover, and storyboard with Media Desk for DeepSeek Harness. See how to install it, set up images, and export a draft.

Read →
Model interfaces and workflows

MiniMax H3 vs M-Series in DSH: Which Works?

Beginner guide to MiniMax H3 vs M3 in DSH: why H3 is for video while M3 handles coding, how to avoid region 401 errors, and 4-step DSH setup instructions.

Read →
API credentials and troubleshooting

Kimi API Key Errors: Region, Model and Permissions

Beginner fix guide for Kimi / Moonshot API key errors: match .ai vs .cn URLs, avoid retired model names and K3 Max typos, decode 401/404/429, and set up DSH.

Read →
Image editing and tools

AI Image Editing: Prompts, Masks and Review

Beginner guide to AI image editing without ruining your subject: copy our 4-line prompt template, avoid PNG mask traps, inspect edges, and use DSH safely.

Read →