The name

Leave your shoes at the door.

A genkan is the step just inside a Japanese front door, where the outside comes off before you stand in your home. That is what this is, for everything arriving down your internet connection.

Genkan is a real place in a real house. It is the bit of floor that is neither outside nor properly inside.

Walk into a Japanese home and you do not walk straight in. You step down into a small recessed space, take your street shoes off, leave them there, and step up onto the floor of the house. That space is the genkan (say it GEN-kan, hard g, like get). It is not a security measure and nobody is being searched. It is a boundary made of hospitality: come in, and leave what you have walked through today at the door.

The word is older than the hallway. It comes from the Chinese 玄關, the hidden gate. 玄 means dark, hidden, profound. 関 means barrier, or checkpoint, the same character used for the inspection posts on the old highways. It first meant the entrance to the guest quarters of a Zen monastery, the doorway onto the path, and only later did ordinary houses borrow it for the place the boots come off.

So for a thousand years the word has meant one thing. The gate where the outside stops.

THE STREET THE HOUSE mud, and everything else shoes off, and left here this bit of floor is the genkan clean, and stays that way

Which is the whole idea here. Your internet connection brings the entire world into your house at once. Most of it is fine. Some of it is mud, and a good deal of it is engineered, by people paid extremely well to engineer it, to take as much of your kid's attention as it can get and give nothing back. This box is the step it all has to cross first. Leave the dirt in the genkan. It catches what you would rather not have tracked through the house.

Why this exists

It began as a switch to turn the wifi off.

The screens were winning. Not dramatically. Just the ordinary grind.

Three kids, eleven, fourteen and sixteen. The endless scroll, one more round, one more episode, and the same conversation every evening that ended with me physically walking over and taking a device out of somebody's hands. That is not parenting. That is refereeing, badly, seven nights a week.

I went looking for something to help and did not much like what I found. The good parental-control services want a subscription and, in return, a copy of everywhere your children go on the internet. The router apps are clumsy and treat a sixteen-year-old exactly like an eight-year-old. Almost all of it is built to watch children rather than to help them.

So the first version was tiny. One command, on my own hardware, that turned the kids' internet off. That is genuinely all it was, and it was already better than what I had, because the boundary stopped being me standing in a doorway and started being a thing everybody could see.

Every parent knows the fight. The screens win because the tools are built for the platforms, not for you.

Router apps are clumsy. The good parental-control services want a subscription and a copy of everywhere your kids go. Genkan takes the other road: it sits between your kids' devices and the internet as a gateway you own outright, so turning gaming off, holding dinner, or handing over thirty earned minutes is one sentence to an assistant you talk to from your phone.

And once a box like that exists, it may as well look after the rest of the house. The same gateway that meters Roblox is the one that decides your security camera may talk to its own maker and to absolutely nothing else. Parental controls and a household firewall turn out to be the same machine, which is why Genkan is both.

One warm box by the router, and the whole house gets a little calmer.

The actual opponent

You are not up against your kid. You are up against a thousand engineers.

The feed is not badly made. It is superbly made, for a goal that is not your child's. Watch time is ad inventory, so autoplay, streaks, notifications and the scroll that never bottoms out all point one way: keep going, do not stop, do not go outside.

Their side
Recommendation engines tuned every day by teams whose job is another twenty minutes of your child's attention. Meta, TikTok and YouTube are extremely good at this. It is the product.
Your side
One tired parent, at the end of a working day, saying "right, that is enough" for the fourth time and being negotiated with for the fifth.
Genkan's side
A boundary you agreed once, running quietly in the hallway, that holds on its own. The clock is not you. It is the clock.

This is not a war on screens, and it is certainly not a war on your children. Screens are where their friends are, where their music is, and increasingly where their homework is. The thing worth pushing back on is narrower than that: the deliberate engineering of the bit where four hours vanish and nobody chose it.

So Genkan does not just take time away, it changes what time costs. Music is free and always was. Schoolwork is free. Messaging a parent is free. Gaming and video are the two things on the clock, and when that clock runs out a kid can earn more by learning something rather than by pleading. Effort buys minutes. Nagging does not.

Under the bonnetHow the box is actually put together

A Docker container owns its own network namespace with exactly two interfaces: the uplink, and the USB network card the kids' access point plugs into. The firewall (nftables), the DHCP and DNS server (AdGuard Home) and the children's portal all live inside that namespace, so they physically cannot reach the host, the rest of your home network or your VPN. Not "are configured not to". Cannot.

Postgres holds the desired state. The gateway rebuilds the firewall from it every fifteen seconds, which is why a phone plugged in at 9pm is covered by 9:00:15pm and why a reboot cannot forget that somebody is out of time. The parent dashboard runs on the host, outside the island, so the thing you control it with is not on the network it controls.

Evening the odds, not winning an argument. A parent competing with a global attention business, alone, on willpower, at 9pm, is outgunned. That is not a parenting failure, it is a mismatch. Genkan is simply a bit of the same engineering pointed back the other way, on your side of the wall, working for your house rules.

Then it kept going

Every answer suggested the next question.

01If I can switch it off, why is it all or nothing? Turning off the internet also turns off homework and music. So time started being counted per category. Gaming and video are on the clock. Music and schoolwork are free, because the point was never to minimise screens.
02What happens the moment it runs out? A kid hits a wall and comes to find me, and we are back to arguing. Unless the wall is a door: pass a quiz, do the dishes, earn some back. That was the turn. It stopped being a restriction and became a deal.
03If effort buys minutes, what counts as effort? Whatever a parent decides. Times tables, world flags, the road code, or the weeding. Ask your own AI to write a quiz on whatever your kid is actually into, with a difficulty ramp so they build confidence rather than rage-quit.
04Everything in the house goes through this box now. Including the cameras, the speakers and the doorbell. So it may as well be a proper firewall: smart-home gear fenced off so it cannot be reached from outside and cannot roam your network, while still backing up to its own cloud.

None of that was a plan. It is just what happens when the box in the hallway turns out to be the right place to solve the next problem too. It started as a way to stop dragging teenagers off devices, and it ended up as the household's own gateway.

The rules it was built under

Three decisions that have not moved.

It runs on my family first
Every decision here was made under the pressure of three real children who are smarter than the software and quite willing to prove it. That is why there is a bug bounty in the repo rather than a pretence that they cannot beat it.
Nothing leaves the house
No account, no telemetry, no cloud. The only honest answer to "how do I know you are not monetising my kids' browsing" is: read the code, it runs on your hardware, and it never sends anything anywhere.
Free, and staying that way
MIT licensed, because a tool that shapes how children use the internet should not depend on anybody's subscription staying current, or on a company still existing in three years.
Being straight about it

What this is, and what it is not.

Is

A boundary you set once that holds on its own, so the clock is the clock and not you.

Is not

A way to read your children's messages. It cannot, and it is not built to.

Is

Transparent with kids. It tells them the network is filtered and shows them exactly what it can and cannot see.

Is not

Unbeatable. A determined teenager with mobile data has simply left your network, and the answer to that is a conversation.

Is

Honest about the half-built parts. The roadmap marks nothing as done unless you can run it today.

Is not

A company. One parent built it, then opened it up. There is nobody here looking for a return.

Why give it away? Because I am not the only parent having this argument, and because the thing that makes it trustworthy is the thing that makes it free. You can read every line, run it on your own hardware, and point your own AI at it and ask whether it is telling you the truth. That only works if it belongs to you.