master
John Lauer Videos: ::adom-video widgets; NAT vs mirrored gets captions and chapters d739613 8d ago
WEBVTT

00:00:00.300 --> 00:00:06.003
Hydrogen runs your Linux workspace inside
WSL, on your own Windows PC.

00:00:06.269 --> 00:00:09.740
WSL can network that workspace in two
ways.

00:00:10.045 --> 00:00:14.802
Mirrored shares Windows' own network, so
localhost on Windows and localhost in

00:00:14.802 --> 00:00:16.327
Linux are the same place.

00:00:16.626 --> 00:00:20.346
NAT gives Linux its own small network,
tucked behind Windows.

00:00:20.678 --> 00:00:23.636
Here's how Hydrogen handles both, and why
it matters.

00:00:24.844 --> 00:00:27.704
We start in Settings, under Workspace
networking.

00:00:28.024 --> 00:00:30.285
This PC is on mirrored, the default.

00:00:31.484 --> 00:00:34.637
In Your AIs, we sign Claude out, and back
in.

00:00:34.911 --> 00:00:39.459
Its browser sign-in ends by calling a
localhost port inside the workspace.

00:00:39.758 --> 00:00:43.828
On mirrored, that's the same localhost as
Windows, so it just works.

00:00:45.036 --> 00:00:49.682
Codex works the same way, with its
callback on port 1455.

00:00:50.884 --> 00:00:55.807
Antigravity signs in with Google, then
hands the result back to the workspace.

00:01:06.754 --> 00:01:10.599
Kimi isn't in the image, so Hydrogen
installs it with one click.

00:01:10.892 --> 00:01:14.615
Kimi signs in with a device code, so
nothing has to call back at all.

00:01:14.893 --> 00:01:15.794
All four are signed in.

00:01:17.018 --> 00:01:18.793
So why not use mirrored everywhere?

00:01:19.089 --> 00:01:21.599
Because on some PCs, mirrored is broken.

00:01:21.890 --> 00:01:26.553
A security tool or a firewall policy stops
Windows from reaching the workspace.

00:01:26.862 --> 00:01:30.822
During install, that looked like the
editor never loading, or the workspace

00:01:30.822 --> 00:01:32.036
image failing to build.

00:01:32.337 --> 00:01:36.224
Setup stopped right there, and people gave
up before they ever used Hydrogen.

00:01:36.590 --> 00:01:40.444
Two of them reported it on our wiki, and
that's how we traced it to mirrored

00:01:40.444 --> 00:01:41.002
networking.

00:01:42.234 --> 00:01:43.497
NAT is the way around it.

00:01:43.879 --> 00:01:45.959
Here we switch to NAT in Settings.

00:01:46.264 --> 00:01:50.383
WSL restarts, and the editor reconnects on
its own.

00:01:52.204 --> 00:01:57.755
Hydrogen used to warn, on every NAT
workspace, that AI sign-ins couldn't work.

00:01:58.051 --> 00:02:03.310
That was wrong, because WSL forwards
Windows' localhost into the workspace.

00:02:03.624 --> 00:02:08.129
So now Hydrogen tests the real trip, and
warns only when it actually fails.

00:02:08.445 --> 00:02:11.920
Here, no warning, and every AI is still
signed in.

00:02:13.100 --> 00:02:14.905
Claude signs in on NAT.

00:02:15.174 --> 00:02:19.256
Before you even click, Hydrogen has
checked that Claude's callback port is

00:02:19.256 --> 00:02:23.339
reachable from Windows, so the sign-in
finishes exactly the way it does on

00:02:23.339 --> 00:02:23.835
mirrored.

00:02:25.044 --> 00:02:29.170
Codex, Antigravity, and Kimi sign in on
NAT too.

00:02:29.450 --> 00:02:31.140
Same buttons, same result.

00:02:41.774 --> 00:02:47.075
App dashboards work in both modes, because
Hydrogen opens them at the same localhost

00:02:47.075 --> 00:02:48.274
address either way.

00:02:48.552 --> 00:02:53.700
Here's Parts Search, served from inside
the workspace, pricing a part across three

00:02:53.700 --> 00:02:55.019
distributors, on NAT.

00:02:55.283 --> 00:02:59.758
And if a Windows program already owns an
app's port, the tab now says which

00:02:59.758 --> 00:03:02.800
program, instead of quietly showing the
wrong page.

00:03:03.990 --> 00:03:07.514
During install, setup now handles all of
this for you.

00:03:07.787 --> 00:03:11.334
Step 6 signs you in, and checks that the
editor really loaded.

00:03:11.630 --> 00:03:15.587
If it won't load on mirrored, or Windows
can't reach the workspace, setup switches

00:03:15.587 --> 00:03:19.304
this PC to NAT once, remembers your
original setting, and carries on, instead

00:03:19.304 --> 00:03:21.041
of stopping with a misleading error.

00:03:21.299 --> 00:03:23.372
It never loops.

00:03:23.667 --> 00:03:24.547
A second failure stops, and says why.

00:03:24.896 --> 00:03:30.718
That's in Hydrogen 1.0.701, public today.

00:03:31.894 --> 00:03:33.094
So that's the balance.

00:03:33.397 --> 00:03:37.295
Mirrored by default, because it's the
simplest, and everything connects

00:03:37.295 --> 00:03:37.789
directly.

00:03:38.059 --> 00:03:39.130
NAT automatically, only on the PCs where
mirrored is broken.

00:03:39.398 --> 00:03:41.662
And a one-click switch in Settings, either
way.

00:03:41.957 --> 00:03:48.024
We switch back to mirrored, and all four
AIs are still signed in.