- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add gosuda/portal-tunnel --skill portal-relay-hetzner -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add gosuda/portal-tunnel --skill portal-relay-hetzner -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add gosuda/portal-tunnel --skill portal-relay-hetzner -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add gosuda/portal-tunnel --skill portal-relay-hetzner -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-relay/skills/portal-relay-hetznerFrom the publisher
This skill creates and opens the host. portal-relay deploys the relay on it. Follow ../portal-relay/references/provider-contract.md (the portal-relay skill's contract in this same plugin; the path is relative to this file, so it matches the installed version and needs no network) for the phase order, credential rules, and approval rules. This file adds only what is specific to Hetzner Cloud.
hcloud version. If the CLI is missing, point to the official hcloud install instructions and stop.hcloud context active names the active project context, and a read-only call such as hcloud server-type list -o noheader proves the token works here. Do not open ~/.config/hcloud/cli.toml; it stores the token.When no context works, ask the user to create a project API token in the Hetzner Console and run hcloud context create <name> locally; the CLI prompts for the token, so it never appears in chat or in shell history. A project token can change every resource in that project, so suggest a dedicated project for the relay. In a CI or sandbox environment that the user controls, HCLOUD_TOKEN in its secret store also works; never set it in a command line.
Collect and show, then wait for approval:
hcloud location list) and server type (hcloud server-type list; read current names and prices from hcloud server-type describe <type> instead of assuming them). The smallest Arm or x86 type is enough; the relay image supports linux/arm64 and linux/amd64.hcloud image list --type system.hcloud ssh-key list, or the user's public key added with hcloud ssh-key create --public-key-from-file. Without one Hetzner emails a root password; avoid that.hcloud primary-ip create --type ipv4 --name <name> --location <location>, with auto-delete off) and pass it with --primary-ipv4, so the glue address survives server re-creation.--enable-protection delete,rebuild against accidental deletion.hcloud firewall create --name <name> --rules-file rules.json, where each rule is {"direction": "in", "protocol": "tcp" | "udp", "port": "443" | "40000-40009", "source_ips": ["0.0.0.0/0", "::/0"]} (restrict SSH to the operator's address when known).hcloud server create --name <name> --type <type> --image <image> --location <location> --ssh-key <key> --firewall <firewall> --primary-ipv4 <ip>.hcloud server ip <name>.Ubuntu images on Hetzner Cloud have no extra host firewall by default; if the user enabled ufw, open the same ports there.
ssh root@<ip> works, and after deployment dig @<ip> <relay domain> NS and curl -fsS https://<relay domain>/api/healthz succeed. A port that times out is usually missing from the Cloud Firewall.Then continue with the portal-relay skill from Verify the host, not from Deploy: a fresh image may lack Docker and Compose v2, and that step checks and, with approval, installs them. Use this host's public address as the glue address. The NS and glue records come before Deploy, at the common skill's Delegate DNS step, because the relay's first start needs them to issue its certificate; the DS comes after Deploy, at Publish the DS. Report the server, firewall, and primary IP with their hourly or monthly price, and rollback: hcloud server delete <name>, hcloud firewall delete <name>, and hcloud primary-ip delete <name> (disable protection first if it was enabled).
Portal can also use Hetzner DNS as its ACME DNS provider (ACME_DNS_PROVIDER=hetzner); that is a relay setting covered by the configuration reference, not by this skill, and Hetzner DNS does not support ENS DNSSEC automation.
Create a Hetzner Cloud server for a Portal relay with the hcloud CLI, attach a Hetzner Cloud Firewall that opens only the relay ports, keep a stable primary IPv4, and hand the host to portal-relay for
---name: portal-relay-hetznerdescription: Create a Hetzner Cloud server for a Portal relay with the hcloud CLI, attach a Hetzner Cloud Firewall that…---# plugins/portal-relay/skills/portal-relay-hetzner/SKILL.mdOverview
Create a Hetzner Cloud server for a Portal relay with the hcloud CLI, attach a Hetzner Cloud Firewall that opens only the relay ports, keep a stable primary IPv4, and hand the host to portal-relay for deployment. Use when the user wants to run a Portal relay on Hetzner Cloud. Do not use for a server that already exists (portal-relay), for DNS changes at Cloudflare (portal-relay-cloudflare), or for Hetzner Robot dedicated servers.
FAQ
Download plugins/portal-relay/skills/portal-relay-hetzner/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/gosuda/portal-tunnel.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.