SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor · Bijgewerkt 2026-11-06

dsh headless draaien als systemd service op een VPS

Voer dsh uit als achtergrondproces met systemd op uw VPS. Leer hoe u een dedicated gebruiker aanmaakt, automatische restarts configureert en logs beheert via journalctl.

Dsh headless uitvoeren op een VPS, buiten een terminal om

Het headless uitvoeren van dsh op een VPS vereist slechts één systemd-unitbestand en een toegewezen gebruiker die het proces beheert. dsh is de command-line launcher voor DeepSeek Harness, de agent-runtime van DeepSeek, die in augustus 2026 als developer preview onder de MIT-licentie is uitgebracht. Een harness is het programma rondom het model, niet het model zelf. U plaatst dus de loop, de tools en de permissies onder systemd, en niet de inferentie van DeepSeek. De quickstart instrueert u om npx @deepseek-ai/dsh web te typen; dit is correct, maar het proces wordt beëindigd zodra u uw SSH-sessie (secure shell) sluit.

Een unitbestand lost direct vier zaken op. De service start automatisch na een reboot. De output wordt naar de journal geschreven in plaats van dat deze voorbij scrolt. Het proces draait onder een account dat niet root is. Bovendien draait u de versie die u heeft gekozen, wat hier belangrijker is dan gebruikelijk, aangezien de upstream-ontwikkelaars dit met hoofdletters aangeven:

DeepSeek Harness bevindt zich momenteel in developer preview en ondergaat snelle iteraties. ER ZULLEN WIJZIGINGEN PLAATSVINDEN DIE DE COMPATIBILITEIT VERBREKEN.

Deze handleiding gaat ervan uit dat dsh handmatig al naar behoren werkt. Mocht dit niet het geval zijn, begin dan met het installeren van DeepSeek Harness op een VPS en keer terug zodra npx @deepseek-ai/dsh web een pagina serveert.

Node eerst, want npm-waarschuwingen zijn onvoldoende

node -v

Het eigen pakket van Ubuntu 24.04 is Node 18 (18.19.1 per augustus 2026), wat verouderd is voor een pakket dat dit jaar is uitgebracht. npm controleert zelf de Node-versies: de documentatie stelt dat het engines-veld van een pakket "alleen waarschuwingen zal genereren" tenzij u engine-strict inschakelt. De gepubliceerde @deepseek-ai/dsh-manifesten bevatten helemaal geen engines-veld (gecontroleerd op 27 oktober 2026 voor 0.1.0-rc.7, 0.2.1-rc.2 en 0.2.1-rc.4), ook al declareert de repository er wel een, maar npm controleert ook de engine-vereisten van afhankelijkheden. De vastgezette 0.2.1-rc.2-release declareert commander: ^15.0.0, en Commander 15 vereist Node >=22.12.0, dus installatie op de Node 18 van Ubuntu produceert een EBADENGINE-waarschuwing onder standaard npm-instellingen. Die waarschuwing stopt de installatie standaard niet, dus controleer Node voordat u een runtime-fout bereikt.

De ondergrens van de repository is ook verschoven. De 0.2.1-rc.2-bron accepteert ^22.19.0 || >=24.0.0, maar het CLI-pakket op de master-branch declareert nu >=24.9.0, waaraan Node 22 niet voldoet. Installeer Node 24 via NodeSource. Dit is een long term support (LTS)-lijn, in onderhoud sinds 20 oktober 2026, en de huidige builds voldoen aan beide bereiken. Node 26 werd LTS op 28 oktober 2026, volgens het Node.js release-schema.

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 -v

node -v zou nu een v24-versie moeten afdrukken, 24.9.0 of nieuwer. De less-regel staat daar omdat het direct doorsturen van een extern script naar bash code uitvoert die u nooit heeft gelezen.

Controleer of het werkt voordat u een unit schrijft

npx @deepseek-ai/dsh@0.2.1-rc.2 web

Laat dit proces draaien. Open een tweede SSH-sessie:

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/

Elke HTTP-statuscode betekent dat het webprofiel luistert op de loopback-interface, waar het standaard aan bindt. Verwacht een 401 en beschouw dit als een succes: de UI authenticeert browsers met een launch token in de afgedrukte URL, die wordt ingewisseld voor een ondertekend sessie-cookie. Een verzoek zonder beide krijgt een 401. 000 in combinatie met curl: (7) Failed to connect to 127.0.0.1 port 3080 betekent dat de service niet luistert; de eerste terminal geeft aan waarom. Stop de handmatige uitvoering met Ctrl+C voordat u verdergaat: een unit die probeert een poort te binden die al in gebruik is, faalt met Error: listen EADDRINUSE: address already in use 127.0.0.1:3080.

0.1.0-rc.7 was de gepubliceerde versie op 18 augustus 2026 en is van voor de browserauthenticatie waar deze handleiding op vertrouwt: de Connection README stelt dat de beveiliging een bereikbaarheidsbeleid is en "de Web carrier biedt geen authenticatielaag". Op 11 oktober 2026 wees de latest-tag naar 0.2.0-rc.2. Op 27 oktober 2026 wees latest naar 0.2.1-rc.2 en next naar 0.2.1-rc.4, dus de commando's hier pinnen 0.2.1-rc.2. Op 4 november 2026 toont de versielijst van npm zowel latest als next op 0.2.1-rc.5; de commando's hier behouden de bestaande pin. Controleer wat actueel is met npm view @deepseek-ai/dsh version en pin vervolgens de versie die u wilt draaien.

Installeer de versie die u heeft vastgezet, globaal

npx is het verkeerde hulpmiddel binnen een unit file. Zonder versie of een overeenkomstige lokale installatie, bepaalt het de pakketversie op het moment dat het proces start. Een herstart over drie maanden kan daardoor een andere build van een preview-agent laden zonder dat u iets heeft aangepast. Ontbrekende pakketten of cachegegevens vereisen bovendien de npm registry; een trage registry kan de opstart vertragen of laten mislukken. npm ondersteunt echter ook uitvoering via cache en offline. Installeer het eenmalig, op een versie die u heeft genoteerd:

sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dsh

command -v dsh toont /usr/bin/dsh wanneer npm afkomstig is van NodeSource, en /usr/local/bin/dsh wanneer het afkomstig is van het eigen pakket van Ubuntu. Gebruik het pad dat daadwerkelijk werd getoond in de unit file. npm ls -g toont de exacte versie; dit is het antwoord dat u over zes weken nodig heeft wanneer het gedrag verandert en u niet meer weet wat u heeft geïnstalleerd. Als de installatie mislukt, of command -v dsh daarna niets toont, of als de versie die u terugkrijgt niet de versie is waar u om vroeg, doorloop dan de gebruikelijke dsh installatie- en versieproblemen voordat u de unit file schrijft.

Een gebruiker die eigenaar is van de service en niets anders

De agent voert shell-commando's uit. Dat is de taak van de agent. Als u deze als root uitvoert, wordt elke tool-aanroep een root-aanroep. Wijs daarom een eigen account toe zonder 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 wordt DSH_HOME, de map waarin dsh profielen bewaart. Een profiel is een benoemde stack van plugin-bundels met uw eigen patch-laag daarbovenop. De profielen web en headless bouwen zichzelf bij de eerste keer opstarten op basis van meegeleverde templates. Alles wat u later aan die stack toevoegt, wordt uitgevoerd als deze gebruiker met de eigen bestands- en shell-toegang van de agent. Daarom hoort het controleren van een plugin voordat u deze installeert bij dezelfde taak als het aanmaken van het account. Die eerste opstart schrijft bestanden en kan bundels ophalen; voer dit daarom handmatig uit zodat u het proces kunt observeren.

sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile web

Stel HOME expliciet in in plaats van te vertrouwen op wat sudo ermee doet. Of sudo de variabele HOME behoudt of herschrijft, hangt namelijk af van instellingen zoals env_reset, env_keep en always_set_home in /etc/sudoers. Als u dit onjuist instelt, probeert de eerste run uw homedirectory te gebruiken voor caches en statusinformatie. Dit veroorzaakt rechtenfouten of plaatst statusinformatie op een locatie die de service later niet gebruikt. Stop het proces met Ctrl+C zodra de curl-controle een statuscode afdrukt.

Het unit-bestand

Schrijf /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.target

ExecStart= gebruikt het absolute pad dat u heeft verkregen via command -v dsh. systemd doorzoekt een vaste lijst met paden voor een kale opdrachtnaam, maar die lijst is niet de PATH van uw shell, dus een absoluut pad voorkomt onduidelijkheid.

WorkingDirectory= is de locatie waar relatieve paden worden opgelost en het is het startpunt voor een tool-aanroep die ls uitvoert zonder argumenten. Wijs dit naar de werkmap die u aan de agent geeft. Als de map ontbreekt of de servicegebruiker geen toegang heeft, faalt de unit met status=200/CHDIR voordat dsh überhaupt wordt uitgevoerd.

ProtectHome=true verbergt /home en /root voor het proces. Dit is hier veilig omdat alles wat de service aanraakt zich onder /var/lib/dsh bevindt. Wijs de werkmap naar een pad onder /home en de agent zal melden dat de map niet bestaat; dit is verwarrend totdat u zich deze regel herinnert. ProtectSystem=full maakt /usr, /boot en /etc alleen-lezen, wat de service nooit hoeft te beschrijven.

Verder gaan is verleidelijk en meestal onjuist. ProtectSystem=strict maakt het volledige bestandssysteem alleen-lezen, afgezien van de kernel-pseudo-bestandssystemen en, met de PrivateTmp=true, /tmp en /var/tmp van deze unit, waardoor schrijfacties naar de werkmap falen met EROFS: read-only file system. Als u dat niveau wenst, voeg dan ReadWritePaths=/var/lib/dsh toe in dezelfde bewerking.

Welk Type= hoort hier thuis

Type=exec, omdat dsh op de voorgrond blijft en nooit een fork uitvoert. Het voordeel ten opzichte van de standaardinstelling is een daadwerkelijke foutmelding. Bij Type=simple markeert systemd de start als succesvol zodra het proces is geforkt, nog voordat bekend is of het binaire bestand überhaupt bestaat. Hierdoor keert systemctl start dsh zonder fouten terug en wordt de fout pas zichtbaar in de journal. Bij Type=exec wacht systemd tot execve() succesvol is afgerond, waardoor een typefout in ExecStart= direct leidt tot een foutmelding in het commando dat u zojuist heeft ingevoerd.

De twee onjuiste antwoorden leiden beide tot een hangend proces. Type=forking instrueert systemd om te wachten tot een ouderproces wordt afgesloten, maar dsh wordt nooit afgesloten. De start blokkeert daarom totdat TimeoutStartSec verloopt (standaard 90 seconden) en rapporteert vervolgens Job for dsh.service failed because a timeout was exceeded.. Type=notify wacht op een READY=1-bericht via sd_notify; een Node-proces dat dit bericht nooit verstuurt, loopt op dezelfde wijze vast. De volledige vergelijking van systemd service types behandelt de overige opties, inclusief situaties waarin het de moeite waard is om notify te configureren.

Herstartregels die luidruchtig falen

Restart=on-failure herstart bij een exitcode die niet nul is of bij een onzuiver signaal, en laat de unit met rust na een schone exit; systemd beschouwt SIGHUP, SIGINT, SIGTERM en SIGPIPE als schone signalen voor dit type service. Dit is het gedrag dat u wenst voor een preview-build. Als dsh ooit afsluit met 0 omdat het een configuratie heeft gelezen die het niet accepteert, stopt de unit en blijft deze gestopt, en toont systemctl status dsh de status inactive (dead) waar u dit kunt zien. Restart=always verandert diezelfde gebeurtenis in een herstartlus die er van een afstand gezond uitziet.

De limiet voor de herstartfrequentie is het onderdeel dat mensen vaak vergeten. De standaardinstellingen van systemd zijn vijf starts binnen tien seconden, en met RestartSec=5s bereikt u nooit vijf starts binnen een venster van tien seconden, waardoor een unit die crasht bij het opstarten voor eeuwig blijft herstarten en alleen het journal dit weet. StartLimitIntervalSec=300 met StartLimitBurst=5 staat vijf starts toe in vijf minuten, waarna het verdere starts binnen dat interval weigert. systemd geeft het op en parkeert de unit in de status failed, waarbij Start request repeated too quickly. wordt gelogd. Wis die status met sudo systemctl reset-failed dsh zodra u de oorzaak heeft verholpen. Beide instellingen horen thuis in [Unit], niet in [Service]; niet-herkende opties produceren waarschuwingslogs in plaats van dat ze stilzwijgend worden genegeerd.

Start de service en controleer deze

sudo systemctl daemon-reload
sudo systemctl enable --now dsh
systemctl status dsh

enable --now voert twee taken uit. enable zorgt ervoor dat de service na een herstart weer opkomt, en --now start de service in de huidige sessie. Een kale systemctl start is na de volgende herstart verdwenen, en kernel-updates vereisen herstarts.

systemctl status dsh hoort Active: active (running), een Main PID en een Memory:-regel te tonen. Controleer vervolgens waar de service luistert:

sudo ss -lntp | grep 3080

U wilt 127.0.0.1:3080 zien. Als u een ander adres ziet, heeft een --host-vlag de listener verplaatst naar het netwerk waar dat adres bij hoort; dit levert onversleuteld HTTP op tenzij TLS is geconfigureerd. De procesnaam in die uitvoer is node, niet dsh, omdat het dsh-binary een Node-script is en pgrep -x dsh daarom niets vindt. Gebruik in plaats daarvan systemctl show -p MainPID dsh.

Herstart daarna de server één keer. Een service die een herstart niet overleeft, is nog geen volwaardige service.

sudo reboot

Maak opnieuw verbinding en voer systemctl is-active dsh uit. Dit geeft active weer.

Logs lezen met journalctl

Alles wat dsh naar stdout en stderr schrijft, komt in de journal terecht onder de unit-naam.

journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err

-f volgt nieuwe regels, -n toont de laatste N regels, -p err filtert op prioriteit. SyslogIdentifier=dsh in de unit is de reden waarom deze regels worden getagd als dsh in plaats van node; dit is van belang wanneer u voor het eerst journal-uitvoer leest die niet op unit is gefilterd.

Controleer of de journal reboots overleeft voordat u deze nodig heeft:

journalctl -u dsh -b -1

Als dit Specifying boot ID or boot offset has no effect, no persistent journal was found weergeeft, bevindt de journal zich in /run en wordt deze bij elke reboot gewist. Maak met Storage=auto de map aan en herstart de daemon; als Storage=volatile is geconfigureerd, wijzig dit dan eerst naar persistent:

sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journald

Voer sudo journalctl --flush uit om over te schakelen naar persistente opslag en de logs van de huidige boot naar de schijf te schrijven.

Bereik de UI via een SSH-tunnel in plaats van een publieke poort

dsh serveert de web-UI (user interface) standaard op 127.0.0.1:3080. Loopback is de standaardinstelling, maar niet de enige keuze: --host accepteert één concreet IPv4- of IPv6-adres van een lokale interface. Elk ander adres dan loopback serveert het netwerk waartoe het behoort via onversleuteld HTTP, met een waarschuwing bij het opstarten, tenzij u ook --tls-cert en --tls-key meegeeft. Wat dsh weigert, is een wildcard. Vraagt u om --host 0.0.0.0, dan begint de foutmelding als volgt:

webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:

Daarin staat verder dat "het binden van elke interface remote code execution zou blootstellen aan het netwerk" en wordt u geadviseerd om "in plaats daarvan één concreet IPv4- of IPv6-adres van een lokale interface te binden". Een waarde die geen IP-literal is, zoals een hostnaam, resulteert in is not a concrete IPv4 or IPv6 address literal.

Houd de standaardinstelling aan. De web-API (application programming interface) stuurt de agent aan en de agent voert shell-commando's uit. dsh plaatst wel authenticatie voor die API: Host- en Origin-controles, plus een launch token in de geprinte URL die de UI inruilt voor een ondertekende sessie-cookie. Via onversleuteld HTTP reist dat token echter in leesbare tekst over het netwerk, en de documentatie van de upstream-ontwikkelaar stelt dat de Host-controle de luisterpoort zelf niet beschermt. Als u de UI op een echte hostnaam nodig heeft, behandelt de gids voor publieke implementaties van DeepSeek een reverse proxy met --public-url en --trusted-host, of native TLS met --tls-cert en --tls-key. Het is raadzaam om wat die 127.0.0.1:3080-regel in de opstartoutput daadwerkelijk betekent te lezen voordat u deze probeert te verplaatsen. Voor een machine die alleen u gebruikt, kunt u de poort vanaf uw eigen computer doorsturen:

ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10

-L 3080:127.0.0.1:3080 opent poort 3080 op uw laptop en stuurt alles wat daar aankomt door naar 127.0.0.1:3080 zoals opgelost op de VPS. -N betekent dat er geen extern commando wordt uitgevoerd, waardoor de sessie alleen de tunnel openhoudt. Laat dit draaien, zoek de URL die dsh bij het opstarten print met journalctl -u dsh -n 100 --no-pager, en open deze in uw browser. Die URL bevat het launch token. Opent u de kale http://127.0.0.1:3080/ in een browser die niet is ingelogd, dan krijgt u een 401-foutmelding. Het token hoort bij het draaiende proces, maar de sessie-cookie die het oplevert, overleeft het proces: de cookie is ondertekend met een geheim dat dsh bewaart in $DSH_HOME/.credentials.yaml en is standaard 30 dagen geldig. Een browser die al is ingelogd, kan de kale URL dus opnieuw openen, zelfs na een herstart. U heeft alleen een nieuwe URL uit de journal nodig voor een nieuwe browser, of zodra die cookie is verlopen. Behandel de URL als een inloggegeven: de upstream-ontwikkelaar adviseert deze alleen te delen met beoogde gebruikers, en iedereen die de systeem-journal kan lezen, kan deze ook lezen. Zodra u binnen bent, voert u daar de DeepSeek API-sleutel in, onder Settings en vervolgens Models, en kiest u daar de werkmap. Wijs de werkmap toe aan /var/lib/dsh/workspace, de map waarvan de service-gebruiker eigenaar is, anders falen de bestandstools van de agent met EACCES: permission denied.

Als poort 3080 bezet is op uw laptop, meldt ssh dit:

bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080

Kies een andere lokale poort met ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10 en open vervolgens de geprinte URL met 3080 gewijzigd naar 3081. Bespaar uzelf het typwerk in ~/.ssh/config op uw eigen machine:

Host dsh-vps
  HostName 203.0.113.10
  User you
  LocalForward 3080 127.0.0.1:3080

Daarna is ssh -N dsh-vps het volledige commando. Deze tunnel is nu de enige toegangspoort tot uw agent, dus de SSH-daemon beschermt deze: alleen sleutels, geen wachtwoordauthenticatie, en de rest van het beveiligen van SSH op uw VPS is hier nog sterker van toepassing dan gebruikelijk. Als die VPS uitgroeit tot een klein privénetwerk, met een database of een staging-omgeving erachter, bespaart het adverteren van die adressen aan uw tailnet met een subnet router u een forward per service, hoewel de UI zelf bij de standaard loopback-instelling van dsh nog steeds via een tunnel binnenkomt.

De sleutel hoort niet thuis in het unit-bestand. Environment=-waarden worden geprint door systemctl show dsh -p Environment, wat elke gebruiker op de machine kan uitvoeren. Als een plugin die u installeert een sleutel in de omgeving nodig heeft, plaats deze dan in /etc/dsh.env met modus 600, eigendom van root, en verwijs ernaar met EnvironmentFile=/etc/dsh.env. systemd leest dat bestand als root tijdens de uitvoering, en systemctl show print de inhoud ervan niet. Welk bestand op schijf elke instelling daadwerkelijk bereikt, en wat uw machine verlaat wanneer u dsh naar een lokaal Ollama-eindpunt wijst in plaats van naar de API van DeepSeek, is het onderwerp van het configureren van de sleutels, modellen en eindpunten van dsh.

Wat de kosten zijn voor het draaien

Inference vindt plaats via de API van DeepSeek, niet op uw VPS. Uw server betaalt voor het Node-proces, de UI die het serveert en elk commando dat de agent besluit uit te voeren. De eerste twee zijn stabiel en klein. De derde wordt door niets in dit unit-bestand begrensd.

Meet de ondergrens op uw eigen server in plaats van te vertrouwen op een cijfer van iemand anders:

systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2

MemoryCurrent wordt uitgedrukt in bytes. Monitor dit terwijl de agent werkt, niet terwijl deze inactief is.

Tool-aanroepen zijn onderliggende processen van de service, dus ze vallen in dezelfde control group en tellen mee voor dezelfde limieten. Een agent die npm install of een testsuite binnen de workspace uitvoert, kan aanzienlijk meer geheugen verbruiken dan de harness zelf. Op een 1 GB VPS is dat waar het misgaat: de kernel kiest een proces en beëindigt dit, en journalctl -k | grep -i "out of memory" toont de Out of memory: Killed process-regel die aangeeft welk proces werd gekozen. Dat proces is vaak niet degene die het probleem veroorzaakte.

De oplossing is een limiet die u bewust instelt. MemoryMax= en CPUQuota= in de sectie [Service] houden de schade binnen de unit, zodat een op hol geslagen build wordt beëindigd in plaats van dat de hele server vastloopt. Geheugen en CPU beperken met systemd behandelt de getallen en het gedrag bij fouten. Schijfgebruik groeit ook, door sessiegeschiedenis onder DSH_HOME en door alles wat de agent in de workspace schrijft, dus voeg du -sh /var/lib/dsh toe aan de tools die u al gebruikt om schijfgebruik te monitoren.

Als u een interactieve agent wilt waar u aan kunt koppelen en van kunt loskoppelen, is een service niet de juiste vorm, en past een agent draaien in een persistente tmux-sessie beter. Draai dsh als een unit wanneer u wilt dat deze altijd actief en bereikbaar is via een tunnel.

Foutmodi en de meldingen die u zult zien

status=203/EXEC. systemd kon het bestand niet uitvoeren en logt Failed to locate executable /usr/local/bin/dsh: No such file or directory. Het pad in ExecStart= komt niet overeen met wat command -v dsh heeft afgedrukt. Dit is de fout die Type=exec rapporteert op het moment van systemctl start in plaats van deze te verbergen.

status=217/USER. systemd kon de gebruikersreferenties uit User= en Group= niet bepalen of wijzigen, of kon geen user namespacing instellen. Voor deze unit is de gebruikelijke oorzaak een account dat niet bestaat. Bevestig dit met id dsh.

status=200/CHDIR. WorkingDirectory= ontbreekt, of de servicegebruiker heeft geen toegang tot deze map. sudo -u dsh ls /var/lib/dsh/workspace reproduceert dit direct.

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. Iets anders houdt de poort bezet, meestal de npx-run die in een andere terminal open is blijven staan. sudo ss -lntp | grep 3080 benoemt het proces.

EACCES: permission denied gevolgd door een pad. Het eigendom onder /var/lib/dsh is onjuist, meestal omdat een eerste run als root of met de verkeerde HOME heeft plaatsgevonden. sudo chown -R dsh:dsh /var/lib/dsh herstelt dit.

Start request repeated too quickly. De unit heeft de startlimiet bereikt en is gestopt. De werkelijke fout staat in de regels daarboven. Voer sudo systemctl reset-failed dsh uit voordat u het opnieuw probeert.

Unit is active (running) maar de browser toont niets. Voer de controle uit op de VPS: als curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ daar een statuscode afdrukt, antwoordt de listener op de VPS, dus controleer daarna de port forward. Die code bewijst niet dat alles is geladen: upstream stelt dat fouten in optionele plugins de gereedheid niet onderdrukken, dus lees ook journalctl -u dsh -n 200 --no-pager voor plugin-fouten. Een 401 in de browser betekent dat er geen geldige sessiecookie aanwezig is en de URL geen geldige launch token bevatte, ofwel omdat u de kale URL heeft geopend of omdat de token van vóór de laatste herstart is. Open de URL die het huidige proces heeft afgedrukt.

Doelbewust upgraden

Door middel van pinning bepaalt u zelf wanneer een upgrade plaatsvindt; het overkomt u niet. Lees eerst de release notes, aangezien de waarschuwing van de upstream-ontwikkelaar over wijzigingen die compatibiliteit verbreken de enige reden is voor de pin. Maak een back-up van de state-directory en wissel vervolgens de versie:

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-pager

Een rollback verloopt op dezelfde wijze als npm install -g met de oude versie, aangevuld met het terugzetten van de tarball. Dit werkt alleen als u daadwerkelijk een back-up heeft gemaakt. Een agent-runtime in de preview-fase is bij uitstek software waarbij een upgrade de configuratie-indeling onder uw handen kan wijzigen.

FAQ

Waarom stopt dsh wanneer ik mijn SSH-sessie sluit?

Omdat npx @deepseek-ai/dsh web een voorgrondproces is dat eigendom is van uw inlogsessie; het wordt beëindigd zodra de sessie eindigt. Een systemd-unit is eigendom van het init-systeem, waardoor deze blijft draaien na het verbreken van de verbinding en automatisch start na een reboot. sudo systemctl enable --now dsh is de combinatie van stappen die beide biedt: enable voor de reboot, --now voor de huidige opstart.

Moet ik Type=simple of Type=exec gebruiken voor dsh?

Type=exec. dsh draait op de voorgrond en voert nooit een fork uit, dus beide werken. Echter, Type=exec zorgt ervoor dat systemd wacht tot execve() slaagt voordat de start als succesvol wordt gemarkeerd. Een onjuist pad in ExecStart= zorgt er dan voor dat systemctl start faalt met status=203/EXEC in beeld. Bij Type=simple resulteert dezelfde fout in een succesmelding en blijft deze verborgen in de journal. Type=forking en Type=notify zijn beide onjuist in dit scenario en zorgen voor een hangende status totdat TimeoutStartSec standaard na 90 seconden verloopt.

Hoe open ik de dsh web-UI vanaf mijn laptop?

Forward de poort via SSH: ssh -N -L 3080:127.0.0.1:3080 you@your-vps, en open vervolgens de URL die dsh bij het opstarten toonde (deze kunt u terugvinden met journalctl -u dsh) in uw browser. Die URL bevat het opstarttoken; een browser die niet is ingelogd krijgt zonder dit token een 401-foutmelding. Eenmaal ingelogd blijft de sessie-cookie standaard 30 dagen geldig en overleeft deze een herstart van de service. Laat de service op de standaard loopback-instelling staan. dsh weigert een wildcard zoals --host 0.0.0.0 als een ongespecificeerd adres. Hoewel het een concreet lokaal adres accepteert, serveert een binding op een niet-loopback-adres standaard HTTP, tenzij u TLS configureert. Zonder TLS wordt het opstarttoken voor een agent die shell-commando's over het netwerk uitvoert, in leesbare tekst verzonden.

Kan ik dsh als root draaien om de rechten eenvoudig te houden?

Nee. De harness is ontworpen om commando's uit te voeren en bestanden te schrijven; de rechten van de service zijn dus de rechten van de agent. Maak een systeemaccount aan met useradd --system --shell /usr/sbin/nologin dsh, wijs het eigendom van /var/lib/dsh toe aan dit account en voeg NoNewPrivileges=true toe aan de unit. Als u daarna tegen EACCES: permission denied aanloopt, is de gebruikelijke oorzaak een eerdere uitvoering als root, waardoor bestanden met root-eigendom zijn achtergebleven. sudo chown -R dsh:dsh /var/lib/dsh lost dit op.

Welke versie van dsh moet ik vastzetten in de unit?

De versie die npm view @deepseek-ai/dsh version rapporteert wanneer u de service instelt, geïnstalleerd met npm install -g @deepseek-ai/dsh@<that version> en vastgelegd op een plek waar u deze terug kunt vinden. 0.1.0-rc.7 was actueel op 18 augustus 2026, 0.2.0-rc.2 op 11 oktober 2026 en 0.2.1-rc.2 op 27 oktober 2026, waarbij next al op 0.2.1-rc.4 zat. Op 4 november 2026 verwijzen zowel latest als next naar 0.2.1-rc.5. Builds zo oud als 0.1.0-rc.7 beschikken niet over browserauthenticatie; pin daarom geen van deze versies voor het webprofiel. Het gaat niet om het versienummer, maar om het feit dat npx zonder versie het pakket pas bij het opstarten ophaalt. Hierdoor kan een onbeheerde herstart u ongemerkt overzetten naar een build met een afwijkend configuratieformaat.

Was dit artikel nuttig?