VPS पर dsh को systemd service के रूप में कैसे चलाएं
VPS पर dsh को background में चलाने के लिए systemd unit file सेटअप करें। यह गाइड समर्पित यूजर, वर्जन पिनिंग, ऑटो-रीस्टार्ट और journalctl लॉग्स के साथ सुरक्षित कॉन्फ़िगरेशन सिखाती है।
VPS पर dsh को headless चलाएं, terminal में नहीं
VPS पर dsh को headless चलाने का अर्थ है एक systemd unit file बनाना और उसे चलाने के लिए एक समर्पित user का उपयोग करना। dsh, DeepSeek Harness के लिए command line launcher है। यह DeepSeek का agent runtime है, जिसे अगस्त 2026 में developer preview के रूप में MIT licence के तहत जारी किया गया था। Harness वह program है जो model के चारों ओर काम करता है, न कि स्वयं model। इसलिए, आप systemd के अंतर्गत loop, tools और permissions को डाल रहे हैं, न कि DeepSeek की inference को। Quickstart आपको npx @deepseek-ai/dsh web टाइप करने के लिए कहता है, जो सही है, लेकिन आपके SSH (secure shell) session को बंद करते ही यह बंद हो जाता है।
एक unit file एक साथ चार समस्याओं को हल करती है। reboot के बाद service अपने आप चालू हो जाती है। इसका output आपके सामने scroll होने के बजाय journal में चला जाता है। यह root के बजाय एक सामान्य account के रूप में चलती है। और यह वही version चलाती है जिसे आपने चुना है, जो यहाँ सामान्य से अधिक महत्वपूर्ण है, क्योंकि upstream ने इसे बड़े अक्षरों में लिखा है:
DeepSeek Harness वर्तमान में developer preview में है और इसमें तेजी से बदलाव हो रहे हैं। इसमें ऐसे बदलाव होंगे जो compatibility को तोड़ सकते हैं।
यह guide मानती है कि dsh आपके लिए manual रूप से पहले से ही काम कर रहा है। यदि ऐसा नहीं है, तो VPS पर DeepSeek Harness install करने से शुरुआत करें और जब npx @deepseek-ai/dsh web एक page serve करने लगे, तब वापस आएँ।
सबसे पहले Node, क्योंकि npm की चेतावनियाँ पर्याप्त नहीं हैं
node -vUbuntu 24.04 का अपना पैकेज Node 18 (अगस्त 2026 तक 18.19.1) है, जो इस वर्ष प्रकाशित किसी पैकेज के लिए काफी पुराना है। npm स्वयं Node वर्ज़न की जाँच करता है: इसके दस्तावेज़ों के अनुसार, किसी पैकेज का engines फ़ील्ड तब तक "केवल चेतावनियाँ देगा" जब तक आप engine-strict को सक्षम नहीं करते। प्रकाशित @deepseek-ai/dsh मैनिफ़ेस्ट में कोई engines फ़ील्ड नहीं होता (27 अक्टूबर 2026 को 0.1.0-rc.7, 0.2.1-rc.2 और 0.2.1-rc.4 के लिए जाँच की गई), भले ही रिपॉजिटरी में इसकी घोषणा की गई हो, लेकिन npm निर्भरताओं (dependencies) की इंजन आवश्यकताओं की भी जाँच करता है। पिन किया गया 0.2.1-rc.2 रिलीज़ commander: ^15.0.0 घोषित करता है, और Commander 15 के लिए Node >=22.12.0 की आवश्यकता है, इसलिए इसे Ubuntu के Node 18 पर इंस्टॉल करने से सामान्य npm सेटिंग्स के तहत EBADENGINE चेतावनी मिलती है। वह चेतावनी डिफ़ॉल्ट रूप से इंस्टॉलेशन को नहीं रोकती है, इसलिए रनटाइम विफलता तक पहुँचने से पहले Node की जाँच करें।
रिपॉजिटरी का न्यूनतम वर्ज़न भी बदल गया है। 0.2.1-rc.2 सोर्स ^22.19.0 || >=24.0.0 को स्वीकार करता है, लेकिन मास्टर ब्रांच पर CLI पैकेज अब >=24.9.0 घोषित करता है, जिसे Node 22 पूरा नहीं करता है। NodeSource से Node 24 इंस्टॉल करें। यह एक लॉन्ग टर्म सपोर्ट (LTS) लाइन है, जो 20 अक्टूबर 2026 से मेंटेनेंस में है, और इसके वर्तमान बिल्ड दोनों श्रेणियों को पूरा करते हैं। Node.js रिलीज़ शेड्यूल के अनुसार, Node 26, 28 अक्टूबर 2026 को LTS बन गया।
curl -fsSL https://deb.nodesource.com/setup_24.x -o /tmp/nodesource_setup.sh
less /tmp/nodesource_setup.sh
sudo -E bash /tmp/nodesource_setup.sh
sudo apt install -y nodejs
node -vnode -v को अब v24 वर्ज़न, 24.9.0 या उससे नया प्रिंट करना चाहिए। less लाइन इसलिए है क्योंकि रिमोट स्क्रिप्ट को सीधे bash में पाइप करने से ऐसा कोड चलता है जिसे आपने कभी पढ़ा नहीं है।
Unit लिखने से पहले सुनिश्चित करें कि यह चल रहा है
npx @deepseek-ai/dsh@0.2.1-rc.2 webइसे चलते रहने दें। दूसरे SSH session से यह चलाएँ:
curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/कोई भी HTTP status code मिलने का मतलब है कि web profile loopback पर listen कर रहा है, जहाँ यह डिफ़ॉल्ट रूप से bind होता है। 401 की अपेक्षा रखें और इसे सफल मानें: UI ब्राउज़र को प्रिंट किए गए URL में मौजूद launch token के साथ authenticate करता है, जिसे वह एक signed session cookie के बदले trade करता है, और बिना इनके किए गए request पर 401 error मिलता है। 000 के साथ curl: (7) Failed to connect to 127.0.0.1 port 3080 का मतलब है कि यह listen नहीं कर रहा है, और पहला terminal आपको इसका कारण बता रहा है। आगे बढ़ने से पहले Ctrl+C दबाकर manual run को रोकें: यदि कोई unit ऐसे port को bind करने की कोशिश करती है जिसे पहले से ही किसी अन्य process ने hold कर रखा है, तो वह Error: listen EADDRINUSE: address already in use 127.0.0.1:3080 error के साथ fail हो जाएगी।
0.1.0-rc.7, 18 August 2026 को प्रकाशित version था, और यह उस browser authentication से पहले का है जिस पर यह guide आधारित है: इसके Connection README में लिखा है कि fence एक reachability policy है और "Web carrier कोई authentication layer प्रदान नहीं करता है"। 11 October 2026 को latest tag 0.2.0-rc.2 पर point कर रहा था। 27 October 2026 को latest ने 0.2.1-rc.2 को और next ने 0.2.1-rc.4 को point किया, इसलिए यहाँ दिए गए commands 0.2.1-rc.2 को pin करते हैं। 4 November 2026 को, npm's version listing में latest और next दोनों 0.2.1-rc.5 पर दिखाई देते हैं; यहाँ दिए गए commands मौजूदा pin को बनाए रखते हैं। npm view @deepseek-ai/dsh version के साथ जाँचें कि वर्तमान में क्या उपलब्ध है, फिर जिसे आप चलाना चाहते हैं उसे pin करें।
पिन किए गए वर्ज़न को ग्लोबली इंस्टॉल करें
unit file के अंदर npx का उपयोग करना गलत है। यदि आप वर्ज़न निर्दिष्ट नहीं करते हैं या स्थानीय इंस्टॉलेशन मेल नहीं खाता है, तो यह प्रोसेस शुरू होते समय पैकेज वर्ज़न को रिज़ॉल्व करता है। इस कारण, तीन महीने बाद रीस्टार्ट करने पर preview-stage एजेंट का कोई अलग बिल्ड चल सकता है, जबकि आपने अपनी तरफ से कोई बदलाव नहीं किया होगा। पैकेज न होने या कैश डेटा की कमी होने पर भी npm registry की आवश्यकता पड़ती है, इसलिए धीमी registry स्टार्टअप को धीमा कर सकती है या विफल कर सकती है; npm कैश और ऑफलाइन निष्पादन का भी समर्थन करता है। एक बार इंस्टॉल करें, उस वर्ज़न के साथ जिसे आपने नोट किया है:
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dshcommand -v dsh तब /usr/bin/dsh प्रिंट करता है जब npm NodeSource से आया हो, और /usr/local/bin/dsh तब जब यह Ubuntu के अपने पैकेज से आया हो। unit file में उसी पाथ का उपयोग करें जो प्रिंट हुआ है। npm ls -g सटीक वर्ज़न प्रिंट करता है, जो छह सप्ताह बाद तब काम आता है जब व्यवहार बदल जाता है और आपको याद नहीं रहता कि आपने क्या इंस्टॉल किया था। यदि इंस्टॉलेशन विफल हो जाता है, या command -v dsh बाद में कुछ भी प्रिंट नहीं करता है, या आपको मिला वर्ज़न वह नहीं है जो आपने मांगा था, तो unit file लिखने से पहले सामान्य dsh इंस्टॉलेशन और वर्ज़न विफलताओं को हल करें।
एक उपयोगकर्ता जो केवल सर्विस का स्वामी हो
एजेंट शेल कमांड चलाता है। यही उसका काम है। इसे root के रूप में चलाने का अर्थ है कि हर टूल कॉल एक root टूल कॉल बन जाता है, इसलिए इसे बिना login shell वाला अपना एक अलग अकाउंट दें।
sudo useradd --system --create-home --home-dir /var/lib/dsh --shell /usr/sbin/nologin dsh
sudo install -d -o dsh -g dsh -m 750 /var/lib/dsh/harness /var/lib/dsh/workspace
id dsh/var/lib/dsh/harness बदलकर DSH_HOME हो जाता है, जो वह डायरेक्टरी है जहाँ dsh प्रोफाइल रखता है। एक प्रोफाइल प्लगइन बंडलों का एक नामित स्टैक है जिसके ऊपर आपकी अपनी पैच लेयर होती है, और web तथा headless प्रोफाइल पहली बार बूट करने पर शिप किए गए टेम्प्लेट से खुद को तैयार करते हैं। बाद में आप उस स्टैक में जो कुछ भी जोड़ते हैं, वह एजेंट के अपने फाइल और शेल एक्सेस के साथ इसी उपयोगकर्ता के रूप में चलता है, इसलिए प्लगइन इंस्टॉल करने से पहले उसकी जांच करना उसी कार्य का हिस्सा है जो अकाउंट बनाना है। वह पहला बूट फाइलें लिखता है और बंडल फेच कर सकता है, इसलिए इसे मैन्युअल रूप से करें जहाँ आप इसे देख सकें।
sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile websudo इसके साथ क्या करता है, इस पर भरोसा करने के बजाय HOME को स्पष्ट रूप से सेट करें, क्योंकि sudo, HOME को सुरक्षित रखता है या फिर से लिखता है, यह /etc/sudoers में मौजूद env_reset, env_keep और always_set_home जैसी सेटिंग्स पर निर्भर करता है। यदि आप इसे गलत करते हैं, तो पहला रन कैश और स्टेट के लिए आपके होम डायरेक्टरी का उपयोग करने का प्रयास करेगा, जिससे परमिशन एरर हो सकते हैं या स्टेट ऐसी जगह चला जाएगा जिसका उपयोग सर्विस बाद में नहीं करेगी। जब curl चेक स्टेटस कोड प्रिंट करे, तो इसे Ctrl+C के साथ रोक दें।
Unit file
Write /etc/systemd/system/dsh.service:
[Unit]
Description=DeepSeek Harness (dsh) web profile
Documentation=https://github.com/deepseek-ai/deepseek-harness
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5
[Service]
Type=exec
User=dsh
Group=dsh
WorkingDirectory=/var/lib/dsh/workspace
Environment=HOME=/var/lib/dsh
Environment=DSH_HOME=/var/lib/dsh/harness
ExecStart=/usr/bin/dsh --profile web
Restart=on-failure
RestartSec=5s
TimeoutStopSec=30s
SyslogIdentifier=dsh
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=full
ProtectHome=true
[Install]
WantedBy=multi-user.targetExecStart= में वह absolute path डालें जो आपको command -v dsh से मिला है। systemd एक bare command name के लिए निश्चित path list में खोज करता है, लेकिन वह list आपके shell का PATH नहीं है, इसलिए absolute path का उपयोग करने से अनिश्चितता खत्म हो जाती है।
WorkingDirectory= वह स्थान है जहाँ relative paths resolve होते हैं, और यहीं से वह tool call शुरू होता है जो बिना किसी argument के ls चलाता है। इसे उस workspace पर point करें जिसे आप agent को देते हैं। यदि directory मौजूद नहीं है या service user उसमें प्रवेश नहीं कर सकता है, तो dsh के चलने से पहले ही service status=200/CHDIR error के साथ fail हो जाएगी।
ProtectHome=true प्रक्रिया से /home और /root को छिपा देता है। यहाँ यह सुरक्षित है क्योंकि service जिन भी चीजों का उपयोग करती है, वे /var/lib/dsh के अंतर्गत ही रहती हैं। यदि आप workspace को /home के अंतर्गत किसी path पर point करेंगे, तो agent यह रिपोर्ट करेगा कि directory मौजूद नहीं है; यह तब तक भ्रमित करने वाला लगता है जब तक आपको इस line का ध्यान न आए। ProtectSystem=full, /usr, /boot और /etc को read-only बना देता है, जिन्हें service को कभी भी write करने की आवश्यकता नहीं होती।
आगे बढ़ना आकर्षक लग सकता है लेकिन आमतौर पर यह गलत होता है। ProtectSystem=strict kernel pseudo-filesystems और इस unit के PrivateTmp=true, /tmp तथा /var/tmp को छोड़कर पूरे filesystem को read-only बना देता है, इसलिए workspace पर किए गए writes EROFS: read-only file system के साथ fail हो जाते हैं। यदि आप उस स्तर की सुरक्षा चाहते हैं, तो उसी edit में ReadWritePaths=/var/lib/dsh जोड़ें।
यहाँ कौन सा Type= होना चाहिए
Type=exec, क्योंकि dsh foreground में रहता है और कभी fork नहीं करता है। default की तुलना में इसका लाभ यह है कि आपको वास्तविक error message मिलता है। Type=simple के साथ, systemd start को सफल मान लेता है जैसे ही यह fork होता है, इससे पहले कि उसे पता चले कि binary मौजूद भी है या नहीं, इसलिए systemctl start dsh सफलतापूर्वक return हो जाता है और विफलता केवल journal में दिखाई देती है। Type=exec के साथ, systemd execve() के सफल होने का इंतज़ार करता है, इसलिए ExecStart= में कोई typo होने पर आपके द्वारा टाइप की गई command विफल हो जाती है, जिसे आप तुरंत देख सकते हैं।
दोनों गलत उत्तरों के कारण प्रक्रिया hang हो जाती है। Type=forking systemd को parent process के exit होने का इंतज़ार करने के लिए कहता है, और dsh कभी exit नहीं होता है, इसलिए start तब तक block रहता है जब तक TimeoutStartSec समाप्त नहीं हो जाता (default रूप से 90 seconds) और फिर Job for dsh.service failed because a timeout was exceeded. रिपोर्ट करता है। Type=notify, sd_notify पर READY=1 संदेश की प्रतीक्षा करता है, और एक Node process जो कभी ऐसा संदेश नहीं भेजती, वह भी इसी तरह रुक जाती है। systemd service types की पूरी तुलना बाकी जानकारी कवर करती है, जिसमें यह भी शामिल है कि notify को कब कॉन्फ़िगर करना सार्थक होता है।
Restart नियम जो स्पष्ट रूप से विफल होते हैं
Restart=on-failure किसी non-zero exit या unclean signal पर restart करता है, और clean exit के बाद unit को वैसे ही छोड़ देता है; systemd इस service type के लिए SIGHUP, SIGINT, SIGTERM और SIGPIPE को clean signals के रूप में मानता है। preview build से आपको यही व्यवहार चाहिए। यदि dsh कभी 0 exit code के साथ बंद होता है क्योंकि उसने ऐसी config पढ़ी जो उसे पसंद नहीं आई, तो unit रुक जाती है और रुकी ही रहती है, और systemctl status dsh में inactive (dead) दिखाई देता है जहाँ आप इसे देख सकते हैं। Restart=always उसी घटना को एक restart loop में बदल देता है जो दूर से देखने पर सही (healthy) लगता है।
Rate limit वह हिस्सा है जिसे लोग छोड़ देते हैं। systemd की default settings दस सेकंड के भीतर पाँच starts हैं, और RestartSec=5s के साथ आप दस सेकंड की अवधि में पाँच starts तक कभी नहीं पहुँचते, इसलिए जो unit startup पर ही crash हो जाती है वह हमेशा restart होती रहती है और केवल journal को ही इसका पता चलता है। StartLimitBurst=5 के साथ StartLimitIntervalSec=300 पाँच मिनट में पाँच starts की अनुमति देता है, फिर उस interval के भीतर किसी और start से मना कर देता है। systemd प्रयास छोड़ देता है और unit को failed में पार्क कर देता है, और Start request repeated too quickly. log करता है। कारण ठीक करने के बाद sudo systemctl reset-failed dsh के साथ उस state को clear करें। दोनों settings [Unit] में होनी चाहिए, न कि [Service] में; unrecognized options चुपचाप ignore होने के बजाय warning logs उत्पन्न करते हैं।
इसे start करें, फिर इसकी जाँच करें
sudo systemctl daemon-reload
sudo systemctl enable --now dsh
systemctl status dshenable --now दो काम करता है। enable वह कमांड है जो reboot के बाद service को वापस लाता है, और --now इसे वर्तमान boot में start करता है। केवल systemctl start का उपयोग करने पर service अगले reboot के बाद हट जाएगी, और kernel updates के कारण reboot करना आवश्यक होता है।
systemctl status dsh को Active: active (running), एक Main PID, और एक Memory: लाइन दिखानी चाहिए। इसके बाद पुष्टि करें कि यह कहाँ listen कर रहा है:
sudo ss -lntp | grep 3080आपको 127.0.0.1:3080 की आवश्यकता है। यदि आपको कोई अन्य address दिखाई देता है, तो इसका मतलब है कि किसी --host flag ने listener को उस network पर स्थानांतरित कर दिया है जिससे वह address संबंधित है, और यदि TLS सेट नहीं है तो यह plain HTTP serve करेगा। उस output में process का नाम node है, न कि dsh, क्योंकि dsh binary एक Node script है, इसलिए pgrep -x dsh को कुछ नहीं मिलता। इसके बजाय systemctl show -p MainPID dsh का उपयोग करें।
फिर एक बार reboot करें। जो service कभी reboot के बाद भी चालू नहीं रही, वह अभी तक एक पूर्ण service नहीं है।
sudo rebootReconnect करें और systemctl is-active dsh चलाएँ। यह active print करता है।
journalctl के साथ लॉग पढ़ना
dsh जो कुछ भी stdout और stderr पर लिखता है, वह unit नाम के तहत journal में दर्ज हो जाता है।
journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err-f नई लाइनों को फॉलो करता है, -n अंतिम N लाइनें दिखाता है, और -p err प्राथमिकता के आधार पर फिल्टर करता है। unit में SyslogIdentifier=dsh का उपयोग इसलिए किया जाता है ताकि उन लाइनों को dsh के रूप में टैग किया जा सके, न कि node के रूप में। यह तब महत्वपूर्ण होता है जब आप पहली बार ऐसा journal आउटपुट पढ़ते हैं जो unit द्वारा फिल्टर नहीं किया गया है।
यह सुनिश्चित करें कि आपको आवश्यकता पड़ने से पहले ही journal रीबूट के बाद भी सुरक्षित रहे:
journalctl -u dsh -b -1यदि यह Specifying boot ID or boot offset has no effect, no persistent journal was found प्रिंट करता है, तो इसका मतलब है कि journal /run में रहता है और हर रीबूट पर डिलीट हो जाता है। Storage=auto के साथ, डायरेक्टरी बनाएँ और daemon को रीस्टार्ट करें; यदि Storage=volatile कॉन्फ़िगर है, तो पहले इसे बदलकर persistent करें:
sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journaldpersistent स्टोरेज पर स्विच करने और वर्तमान बूट के लॉग्स को डिस्क पर फ्लश करने के लिए sudo journalctl --flush चलाएँ।
SSH tunnel के माध्यम से UI तक पहुँचें, न कि public port के जरिए
dsh डिफ़ॉल्ट रूप से 127.0.0.1:3080 पर web UI (user interface) सर्व करता है। Loopback ही डिफ़ॉल्ट है, लेकिन यह एकमात्र विकल्प नहीं है: --host किसी local interface के एक concrete IPv4 या IPv6 address को स्वीकार करता है। Loopback के अलावा कोई भी अन्य address plain HTTP पर संबंधित network को सर्व करता है, जिसके लिए startup पर एक चेतावनी दी जाती है, जब तक कि आप --tls-cert और --tls-key पास न करें। dsh wildcard को स्वीकार करने से मना कर देता है। यदि आप --host 0.0.0.0 का अनुरोध करते हैं, तो error इस प्रकार शुरू होता है:
webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:इसमें आगे कहा गया है कि "हर interface को bind करने से network पर remote code execution का खतरा हो सकता है" और आपको "इसके बजाय किसी local interface के एक concrete IPv4 या IPv6 address को bind करने" के लिए कहा जाता है। यदि कोई value IP literal नहीं है, जैसे कि hostname, तो वह is not a concrete IPv4 or IPv6 address literal के साथ विफल हो जाती है।
डिफ़ॉल्ट को ही रहने दें। Web API (application programming interface) agent को चलाता है, और agent shell commands रन करता है। dsh उस API के सामने authentication लगाता है: Host और Origin checks, साथ ही printed URL में एक launch token जिसे UI एक signed session cookie के बदले स्वीकार करता है। हालाँकि, plain HTTP पर वह token network में cleartext के रूप में जाता है, और upstream के अपने docs का कहना है कि Host check listening port की सुरक्षा नहीं करता है। यदि आपको UI को किसी real hostname पर चाहिए, तो DeepSeek की public deployments guide में --public-url और --trusted-host के साथ reverse proxy, या --tls-cert और --tls-key के साथ native TLS का उपयोग करने के बारे में बताया गया है। startup output में उस 127.0.0.1:3080 लाइन का वास्तविक अर्थ क्या है इसे बदलने की कोशिश करने से पहले पढ़ना उपयोगी है। यदि आप उस box का उपयोग अकेले करते हैं, तो इसके बजाय अपनी machine से port को forward करें:
ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10-L 3080:127.0.0.1:3080 आपके laptop पर port 3080 खोलता है और वहाँ आने वाली किसी भी चीज़ को VPS पर resolve होने वाले 127.0.0.1:3080 पर भेज देता है। -N का अर्थ है कि कोई remote command रन न करें, ताकि session केवल tunnel को खुला रखे। इसे चलते रहने दें, journalctl -u dsh -n 100 --no-pager के साथ startup पर dsh द्वारा print किए गए URL को ढूँढें, और उसे अपने browser में खोलें। उस URL में launch token होता है। यदि आप किसी ऐसे browser में bare http://127.0.0.1:3080/ खोलते हैं जिसने sign in नहीं किया है, तो आपको 401 error मिलेगा। Token running process का होता है, लेकिन जो session cookie यह खरीदता है वह process से अधिक समय तक चलता है: cookie को एक secret के साथ sign किया जाता है जिसे dsh $DSH_HOME/.credentials.yaml में रखता है और यह डिफ़ॉल्ट रूप से 30 दिनों तक चलता है। इसलिए, जिस browser ने पहले ही sign in कर लिया है, वह restart के बाद भी bare URL को फिर से खोल सकता है। आपको केवल नए browser के लिए, या cookie की अवधि समाप्त होने के बाद ही journal से नए URL की आवश्यकता होती है। URL को एक credential की तरह मानें: upstream का कहना है कि इसे केवल इच्छित users के साथ ही साझा करें, और जो कोई भी system journal पढ़ सकता है, वह इसे भी पढ़ सकता है। एक बार अंदर जाने के बाद, यहीं पर आप Settings के अंतर्गत Models में DeepSeek API key दर्ज करते हैं, और यहीं आप workspace directory चुनते हैं। Workspace को /var/lib/dsh/workspace पर point करें, जो वह directory है जिसका owner service user है, अन्यथा agent के file tools EACCES: permission denied के साथ विफल हो जाएंगे।
यदि आपके laptop पर port 3080 व्यस्त है, तो ssh यह बताता है:
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10 के साथ एक अलग local port चुनें, फिर 3080 को 3081 में बदलकर print किए गए URL को खोलें। अपनी machine पर ~/.ssh/config में टाइपिंग बचाएं:
Host dsh-vps
HostName 203.0.113.10
User you
LocalForward 3080 127.0.0.1:3080उसके बाद, ssh -N dsh-vps ही पूरी command है। यह tunnel अब आपके agent का एकमात्र द्वार है, इसलिए SSH daemon ही इसकी सुरक्षा कर रहा है: केवल keys का उपयोग करें, password authentication का नहीं, और अपने VPS पर SSH को सुरक्षित करने के बाकी नियम सामान्य से अधिक सख्ती से लागू होते हैं। यदि वह VPS अपने आप में एक छोटे private network में विकसित हो जाता है, जिसके पीछे database या staging box है, तो उन addresses को अपने tailnet पर subnet router के साथ advertise करना आपको प्रति service एक forward करने से बचाता है, हालाँकि dsh के loopback डिफ़ॉल्ट पर होने के कारण UI अभी भी tunnel के माध्यम से ही आता है।
Key unit file में नहीं होनी चाहिए। Environment= values को systemctl show dsh -p Environment द्वारा print किया जाता है, जिसे box पर कोई भी user रन कर सकता है। यदि आपके द्वारा install किया गया कोई plugin environment में key मांगता है, तो उसे root के स्वामित्व वाले mode 600 के साथ /etc/dsh.env में रखें और EnvironmentFile=/etc/dsh.env के साथ reference दें। systemd exec के समय उस file को root के रूप में पढ़ता है, और systemctl show इसकी सामग्री को print नहीं करता है। प्रत्येक setting डिस्क पर किस file में जाती है, और जब आप dsh को DeepSeek API के बजाय local Ollama endpoint पर point करते हैं तो आपकी box से क्या बाहर जाता है, यह dsh की keys, models और endpoints को configure करने का विषय है।
इसे चलाने की लागत
Inference DeepSeek के API पर होता है, आपके VPS पर नहीं। आपका सर्वर Node process, इसके द्वारा सर्व किए जाने वाले UI, और एजेंट द्वारा चलाए जाने वाले हर कमांड की लागत उठाता है। पहले दो स्थिर और कम हैं। तीसरा इस unit file में किसी भी चीज़ द्वारा सीमित नहीं है।
किसी और के आंकड़ों पर भरोसा करने के बजाय अपने सर्वर पर न्यूनतम खपत को मापें:
systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2MemoryCurrent बाइट्स में है। इसे तब देखें जब एजेंट काम कर रहा हो, न कि तब जब वह idle हो।
Tool calls सर्विस के child processes होते हैं, इसलिए वे एक ही control group में आते हैं और उन्हीं सीमाओं के अंतर्गत गिने जाते हैं। जो एजेंट workspace के भीतर npm install या test suite चलाता है, वह harness से कहीं अधिक memory का उपयोग कर सकता है। 1 GB के VPS पर यहीं समस्या आती है: kernel एक process को चुनता है और उसे kill कर देता है, और journalctl -k | grep -i "out of memory" में Out of memory: Killed process लाइन दिखती है जो उस process का नाम बताती है जिसे उसने चुना है। वह process अक्सर वह नहीं होती जिसने समस्या पैदा की है।
इसका समाधान वह सीमा है जिसे आप जानबूझकर सेट करते हैं। [Service] section में MemoryMax= और CPUQuota= नुकसान को unit के भीतर ही रखते हैं, ताकि पूरा सर्वर lock होने के बजाय केवल अनियंत्रित build process ही kill हो। systemd के साथ memory और CPU को सीमित करना में इन आंकड़ों और failure के व्यवहार के बारे में बताया गया है। Disk भी भरती है, जो DSH_HOME के अंतर्गत session history और workspace में एजेंट द्वारा लिखी गई किसी भी चीज़ के कारण होता है, इसलिए disk की निगरानी के लिए आप जो भी उपयोग करते हैं, उसमें du -sh /var/lib/dsh को शामिल करें।
यदि आप एक ऐसा interactive एजेंट चाहते हैं जिससे आप जुड़ सकें और अलग हो सकें, तो service सही विकल्प नहीं है, और persistent tmux session में एजेंट चलाना बेहतर काम करता है। जब आप चाहते हैं कि dsh हमेशा चालू रहे और tunnel के माध्यम से सुलभ हो, तभी इसे unit के रूप में चलाएं।
विफलता के प्रकार और वे संदेश जो आपको दिखाई देंगे
status=203/EXEC. systemd फ़ाइल को रन नहीं कर सका, और लॉग Failed to locate executable /usr/local/bin/dsh: No such file or directory में हैं। ExecStart= में दिया गया पाथ उस पाथ से मेल नहीं खाता जो command -v dsh ने प्रिंट किया था। यह वह विफलता है जिसे Type=exec, systemctl start समय पर छिपाने के बजाय रिपोर्ट करता है।
status=217/USER. systemd User= और Group= से उपयोगकर्ता क्रेडेंशियल्स निर्धारित या परिवर्तित करने में, या user namespacing सेट करने में विफल रहा। इस यूनिट के लिए सामान्य कारण एक ऐसा अकाउंट है जो मौजूद नहीं है। id dsh के साथ इसकी पुष्टि करें।
status=200/CHDIR. WorkingDirectory= गायब है, या सर्विस यूजर उसमें प्रवेश नहीं कर सकता। sudo -u dsh ls /var/lib/dsh/workspace इसे सीधे पुनरुत्पादित (reproduce) करता है।
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. किसी अन्य चीज़ ने पोर्ट को होल्ड कर रखा है, आमतौर पर किसी अन्य टर्मिनल में खुला छोड़ा गया npx रन। sudo ss -lntp | grep 3080 उस प्रोसेस का नाम बताता है।
EACCES: permission denied और उसके बाद एक पाथ। /var/lib/dsh के अंतर्गत ओनरशिप गलत है, आमतौर पर इसलिए क्योंकि पहला रन root के रूप में या गलत HOME के साथ हुआ था। sudo chown -R dsh:dsh /var/lib/dsh इसे ठीक करता है।
Start request repeated too quickly. यूनिट स्टार्ट रेट लिमिट तक पहुँच गई और उसने प्रयास करना छोड़ दिया। वास्तविक त्रुटि इसके ऊपर की पंक्तियों में है। दोबारा प्रयास करने से पहले sudo systemctl reset-failed dsh चलाएँ।
यूनिट active (running) है लेकिन ब्राउज़र में कुछ नहीं दिख रहा है। VPS पर चेक चलाएँ: यदि curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ वहाँ एक स्टेटस कोड प्रिंट करता है, तो लिसनर VPS पर जवाब दे रहा है, इसलिए अगला कदम पोर्ट फॉरवर्ड की जाँच करना है। वह कोड यह साबित नहीं करता कि सब कुछ लोड हो गया है: अपस्ट्रीम का कहना है कि वैकल्पिक प्लगइन विफलताएं readiness को बाधित नहीं करती हैं, इसलिए प्लगइन त्रुटियों के लिए journalctl -u dsh -n 200 --no-pager को भी पढ़ें। ब्राउज़र में 401 का मतलब है कि इसमें कोई वैध सेशन कुकी नहीं है और URL में कोई वैध लॉन्च टोकन नहीं है, या तो इसलिए कि आपने खाली URL खोला है या इसलिए कि टोकन पिछले रीस्टार्ट से पहले का है। वह URL खोलें जिसे वर्तमान प्रोसेस ने प्रिंट किया है।
सोच-समझकर अपग्रेड करना
Pinning का अर्थ है कि अपग्रेड एक ऐसी प्रक्रिया है जिसे आप स्वयं करते हैं, न कि वह जो अपने आप हो जाती है। सबसे पहले release notes पढ़ें, क्योंकि upstream द्वारा compatibility-breaking बदलावों के बारे में दी गई चेतावनी ही pinning का मुख्य कारण है। state directory का बैकअप लें, और फिर version बदलें:
sudo systemctl stop dsh
sudo tar czf /root/dsh-home-$(date +%F).tgz -C /var/lib/dsh harness
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
sudo systemctl start dsh
journalctl -u dsh -n 50 --no-pagerRollback करना भी पुराने version के साथ वही npm install -g है, साथ ही उस tarball को restore करना, जो केवल तभी काम करता है यदि आपने उसे लिया हो। एक preview-stage agent runtime बिल्कुल वही software है जहाँ अपग्रेड आपके पीछे से config format को फिर से लिख देता है।
FAQ
SSH session बंद करने पर dsh क्यों रुक जाता है?
क्योंकि npx @deepseek-ai/dsh web आपके login session के स्वामित्व वाली एक foreground process है, इसलिए session समाप्त होने पर इसे बंद कर दिया जाता है। इसके विपरीत, एक systemd unit init system के स्वामित्व में होती है, यही कारण है कि disconnect करने के बाद भी यह चलती रहती है और reboot के बाद फिर से शुरू हो जाती है। sudo systemctl enable --now dsh उन दो चरणों का समूह है जो आपको दोनों सुविधाएँ देता है: reboot के लिए enable, और इस boot के लिए --now।
क्या मुझे dsh के लिए Type=simple या Type=exec का उपयोग करना चाहिए?
Type=exec। dsh foreground में चलता है और कभी fork नहीं होता, इसलिए दोनों काम करते हैं, लेकिन Type=exec यह सुनिश्चित करता है कि start को सफल घोषित करने से पहले systemd execve() के सफल होने का इंतज़ार करे। ExecStart= में गलत path होने पर systemctl start विफल हो जाता है और आपके सामने status=203/EXEC दिखाई देता है। Type=simple के साथ वही गलती सफलता दर्शाती है और journal में छिप जाती है। Type=forking और Type=notify दोनों यहाँ गलत हैं, और दोनों तब तक hang रहते हैं जब तक कि TimeoutStartSec डिफ़ॉल्ट रूप से 90 सेकंड के बाद expire न हो जाए।
मैं अपने laptop से dsh web UI कैसे खोलूँ?
SSH के माध्यम से port को forward करें: ssh -N -L 3080:127.0.0.1:3080 you@your-vps, फिर उस URL को अपने browser में खोलें जिसे dsh ने startup पर print किया था, जिसे आप journalctl -u dsh के साथ ढूँढ सकते हैं। उस URL में launch token होता है, और बिना इसके login न करने वाला browser 401 error देता है। एक बार login करने के बाद, session cookie डिफ़ॉल्ट रूप से 30 दिनों तक चलती है और service restart होने पर भी बनी रहती है। service को उसके loopback डिफ़ॉल्ट पर ही रहने दें। dsh --host 0.0.0.0 जैसे wildcard को unspecified address के रूप में अस्वीकार कर देता है, और हालाँकि यह एक concrete local address को स्वीकार करता है, लेकिन non-loopback bind पर plain HTTP चलता है जब तक कि आप TLS सेटअप न करें। TLS के बिना, यह नेटवर्क पर shell commands चलाने वाले agent के लिए launch token को cleartext में भेजता है।
क्या मैं permissions को सरल रखने के लिए dsh को root के रूप में चला सकता हूँ?
नहीं। यह harness commands चलाने और files लिखने के लिए है, इसलिए service के पास जो भी privileges होंगी, वही agent के पास भी होंगी। useradd --system --shell /usr/sbin/nologin dsh के साथ एक system account बनाएँ, /var/lib/dsh का स्वामित्व उसे दें, और unit में NoNewPrivileges=true जोड़ें। यदि इसके बाद आपको EACCES: permission denied मिलता है, तो इसका सामान्य कारण root के रूप में पहले किया गया run है जिसने root-owned files छोड़ दी हैं, और sudo chown -R dsh:dsh /var/lib/dsh उन्हें हटा देता है।
मुझे unit में dsh का कौन सा version pin करना चाहिए?
service सेटअप करते समय npm view @deepseek-ai/dsh version जो भी report करे, उसे npm install -g @deepseek-ai/dsh@<that version> के साथ install करें और कहीं record कर लें जहाँ आप उसे ढूँढ सकें। 18 अगस्त 2026 को 0.1.0-rc.7 current था, 11 अक्टूबर 2026 को 0.2.0-rc.2, और 27 अक्टूबर 2026 को 0.2.1-rc.2, जबकि next पहले से ही 0.2.1-rc.4 पर था। 4 नवंबर 2026 को, latest और next दोनों 0.2.1-rc.5 की ओर इशारा करते हैं। 0.1.0-rc.7 जितने पुराने builds में browser authentication नहीं है, इसलिए web profile के लिए उनमें से किसी को pin न करें। मुद्दा संख्या का नहीं है, बल्कि यह है कि बिना version के npx start time पर package को resolve करता है, इसलिए एक unattended restart आपको चुपचाप एक ऐसे build पर ले जा सकता है जिसका config format अलग हो।