OXYGENHUB

deploy.md: the socket listens where server.bind says; Earth has it now 9aee52d392a6

Installed on Earth 2026-10-17 as a socket unit on 127.0.0.1:7300 and a
drop-in for the service; a restart under load answered every request.

Closes #233
Author
Andy McCall @andymccall <[email protected]>
via
agent Claude Code <[email protected]> · delegate for changes, until 2026-11-13 19:00Z · key ea5f78160088
When
· 2026-10-17 10:37 UTC
Signature
✔ signed by Claude Code
Hash
9aee52d392a67323824e269c3f0ffdf4c0e066e2bba44bd4d9204368f3a034a1
Depends on
93be9ce4653e c92a99490cba
Depended on by
nothing yet
In bookmarks
api-unknown-fields cancel-landed-runs diffusion-pin-bookmark draft-ready main oh-comment-body-file proposal-list-fast
In tags
v0.6.0 v0.6.1 v0.7.0 v0.8.0 v0.9.0 v0.9.1 v0.9.11 v0.9.15 v0.9.16 v0.9.19 v0.9.2 v0.9.20 v0.9.21 v0.9.22 v0.9.23 v0.9.24 v0.9.3 v0.9.4 v0.9.5 v0.9.6 v0.9.7 v0.9.8 v0.9.9
Edits
3 atoms, 0 tree operations, 1 file

Browse the tree at this change

hide whitespace changes
modified docs/deploy.md +3 −1
… 
51 unchanged lines
52 52 
WantedBy=sockets.target
53 53 
```
54 54 

    

  
    

      55
      
      -
      
Then give `oxygenhub.service` `Requires=oxygenhub.socket`,

    

  
    

      
      55
      +
      
`ListenStream` is the address `server.bind` names in `hub.toml` (Earth's is `127.0.0.1:7300`, behind cloudflared). Then give `oxygenhub.service` `Requires=oxygenhub.socket`,

    

  
    

      56
      56
       
      
`After=oxygenhub.socket` and `TimeoutStopSec=40`, and run:

    

  
    

      57
      57
       
      

    

  
    

      58
      58
       
      
```sh

    

  
    

      
      
      …
      
3 unchanged lines

    

  
    

      62
      62
       
      
sudo systemctl start oxygenhub

    

  
    

      63
      63
       
      
```

    

  
    

      64
      64
       
      

    

  
    

      
      65
      +
      
On Earth the three service lines are a drop-in, `/etc/systemd/system/oxygenhub.service.d/socket.conf` (installed 2026-10-17; a restart under 10 requests a second then answered all 120 with 200).

    

  
    

      
      66
      +
      

    

  
    

      65
      67
       
      
The service's log then says "http on the socket systemd holds". From then on

    

  
    

      66
      68
       
      
`systemctl restart oxygenhub` keeps the socket, so nobody sees a refused

    

  
    

      67
      69
       
      
connection or a Cloudflare 502. HTTPS (7343, the developer edition's

    

  
    

      
      
      …
      
82 unchanged lines