portless Updates & Release Notes
51 updates curated from 1 source by the Releasebot Team. Last updated: Nov 18, 2026
- Nov 18, 2026
- Date parsed from source:Nov 18, 2026
- First seen by Releasebot:Nov 18, 2026
- Modified by Releasebot:Nov 20, 2026
v0.18.1
portless fixes concurrent Turbo runs so each run keeps its own state, tightens command flag validation, and improves alias route removal across configured and former TLDs.
Bug Fixes
Concurrent Turbo runs
Concurrent Turbo runs: Concurrent root Turbo runs no longer share one
~/.portless/dev-manifest.json, so one run cannot overwrite or delete another's entries and start its apps withPORTundefined. Each run publishes and retires only its own data file, a relativePORTLESS_STATE_DIRworks, data from dead runs is swept, and processes that outlive the run can still start Node. (#599)Command flags
Command flags:
get,alias,list,prune,doctor,hosts sync, andproxy startnow accept only the global flags in their own flag spec, so--cloudflare,--ngrok,--tailscale,--funnel, and--scriptare rejected instead of silently ignored.--lanand--ipkeep working onproxy start,service install, anddoctor, leading flags before a command go to that command, a repeated--scriptor--ipexits 2,run --lan=1reports that--lantakes no value,proxy start --https --no-tlsexits 2, and a mismatched--cert/--keyfails before the daemon starts. (#600)Alias removal
Alias removal:
portless alias --removenow removes an alias's static routes on TLDs the proxy no longer serves, and--tldon remove accepts those TLDs. Routes under configured TLDs are matched exactly the way alias adds them, so overlapping TLDs no longer remove another alias's routes, a former TLD nested under a configured one can be selected with--tld, and a long name no longer fails on a route under a longer former TLD. (#601)Contributors
@lahfir
Original source - Nov 16, 2026
- Date parsed from source:Nov 16, 2026
- First seen by Releasebot:Nov 17, 2026
- Modified by Releasebot:Nov 18, 2026
v0.18.0
portless adds machine-readable JSON output for routes and diagnostics, improves CLI help and argument handling, and strengthens cleanup and state-directory safety. It also clarifies output streams, expands app argument forwarding, and improves documentation accessibility.
New Features
JSON output: portless list, portless get, and portless doctor accept --json and write one JSON document to stdout, so scripts can read routes, URLs, upstream settings, and doctor findings without parsing tables. list --json keeps the tunnel fields, including tailscaleFunnel, and doctor --json reports every finding and the summary counts and exits 1 when a finding fails. The MCP tools can pass --json too. (#558)
Improvements
Help text: portless --help is shorter and lists only what the root command accepts. Proxy options moved to portless proxy --help, and --name, --force, and --app-port are listed under the commands that take them. The documented precedence now holds: --https wins over PORTLESS_HTTPS=0, PORTLESS_APP_PORT wins over portless.json appPort, and --script wins over a per-app script. (#560)
TypeScript 7: move the remaining packages to TypeScript 7. The published package is unchanged. (#580)
Bug Fixes
Usage errors: every command parses its flags with one parser, so an unknown or misspelled flag, a missing value, an extra argument, or a boolean written as --force=false exits 2 with a usage message before the proxy starts, a route changes, or a child process runs. --flag=value is accepted for every flag that takes a value, --ip must be an IPv4 or IPv6 address, and a repeated --remove is rejected. Commands that wrap another command pass its arguments through unchanged and keep its exit code, and --help prints help before anything runs, including portless <app> --help. (#556, #557)
Clean and prune: portless clean prints its plan, asks for confirmation on a terminal, requires --yes otherwise, and exits 1 when a step fails. It waits for the proxy to stop before reporting success, and retries the failed CA, state file, and hosts steps with sudo. portless prune keeps a route while an unidentified process holds its port and removes it once the port is free, and only a recorded PID and start time authorize a signal. A route kept for a retry stays in the route store as a retired record, so the next registration wins and a reused PID cannot route to the old port. (#559)
State directory ownership: on macOS and Linux, the proxy and the commands that use the state directory (trust, proxy stop, clean, prune, hosts sync, service install, and --force) now refuse a directory that another user owns, can write to, or can redirect through a symlink, and they stop signalling a PID named by such a directory. A state directory is created with mode 0755, private keys are created under a umask that hides them, and trust says why it refused a directory. (#559)
Output streams: run mode, proxy start, and compose status lines go to stderr, so stdout carries only the app's or container's output. NO_COLOR and FORCE_COLOR are honored, and color is decided for each stream from whether that stream is a terminal. A corrupt or unreadable routes.json is reported instead of shown as an empty table, and write paths move the bad file aside with a warning. (#558)
Forwarding arguments: zero-argument and multi-app commands forward arguments after -- to each app they start, with the separator each package manager needs, including npm, pnpm, Yarn Classic, Yarn Berry, bun, and Turbo root scripts. Arguments through a compound script such as foo && bar exit 2 before anything starts, PORTLESS_APP_PORT is refused when several apps start in favor of per-app appPort, and a package's own portless.json now applies in multi-app mode. (#560)
Documentation
Docs site: the chat input sizes itself with field-sizing and ignores an Enter that confirms an IME composition. The search dialog labels its input and clear button, and the desktop and mobile navigation mark the active page with aria-current. (#586)
Contributors
- @lahfir
- @ctate
All of your release notes in one feed
Join Releasebot and get updates from Vercel Labs and hundreds of other software products.
- Nov 8, 2026
- Date parsed from source:Nov 8, 2026
- First seen by Releasebot:Nov 9, 2026
v0.17.0
portless adds HTTPS and HTTP alias backends, flexible worktree hostnames, and selective TLD routing. It also improves proxy reliability and route handling, strengthens command validation, and simplifies documentation.
New Features
- HTTPS alias backends: Added
--upstreamtoportless aliasto route an alias to an HTTPS or HTTP service on loopback.--upstream httpsenables TLS and keeps the incoming Host header.--upstream https://<host>[:<port>]also sets Host to that authority and sends a DNS hostname as SNI, andhttp://<host>[:<port>]sets Host without TLS. Upstream TLS supports HTTP/1.1 backends and does not verify the backend certificate. Restart the proxy after upgrading. (#568) - Worktree hostnames: Added a worktree option to
portless.jsonand the package.json "portless" key.worktree.prefix: "branch"uses the whole branch as the label, so team-a/login becomes team-a-login, andworktree.hostnameTemplatesuch astenant.{worktree}-{name}replaces the whole hostname. Root values apply to every app in a workspace. Set the label directly withportless run --prefix <label>orPORTLESS_PREFIX, with""for none. Duplicate proxied hostnames fail before any app starts. (#548) - Alias TLD selection: Added
--tldtoportless aliasandportless alias --removeto cover only selected configured TLDs. Repeat the flag or pass a comma-separated list. A missing or unconfigured TLD fails before any route changes. (#546)
Bug Fixes
- Alias and proxy stop flags: Reject unknown flags for
portless aliasandportless proxy stop, and print usage for a trailing--help, before any route changes or the proxy stops.portless alias --removeremoves only static routes and keeps routes owned by a running app. (#546) - Loopback connections: Connect to IPv4 and IPv6 loopback in parallel and use the first connection that succeeds, without a fallback timer, so an event-loop stall no longer drops a healthy connection. Proxy errors list each failed loopback address and its error code. (#545)
- Windows route lock: Retry transient EPERM errors when creating the route lock on Windows instead of failing with Failed to acquire route lock. (#553)
Documentation
Simplified the README and moved reference content to the docs site. (#552)
Contributors
- @lahfir
- @Ssoon-m
- @Knat-Dev
- @JulienMartel
- @jaeminbird
- @Railly
- @ctate
- Nov 4, 2026
- Date parsed from source:Nov 4, 2026
- First seen by Releasebot:Nov 5, 2026
v0.16.0
portless adds Docker Compose support with named localhost URLs, letting projects share published HTTP ports, and improves background-server routing, upstream connection handling, and HTTP/2 request bodies.
New Features
- Docker Compose: Added portless compose to run a Compose project with named URLs. Each published HTTP port moves to a fixed port on 127.0.0.1 and gets a
<service>.<project>.localhostroute, so two projects can publish the same host port. Database, cache, and UDP ports keep their published port. Configure services with the portless.enable, portless.name, and portless.ports labels. (#543, #547)
Bug Fixes
- Self-daemonizing commands: Keep the route when a command starts a server in the background and exits, as Astro 7 does in agentic environments. The route moves to the server's PID, portless list shows it, and it drops once the server stops. (#444)
- Upstream connections: Pool connections to the dev server and limit concurrent dials per backend, so a cold HTTP/2 page load no longer overflows the server's accept backlog. Long-lived responses like SSE don't block other requests. (#477)
- HTTP/2 request bodies: Send HTTP/2 request bodies that have no content-length with chunked encoding, so GET, DELETE, and OPTIONS requests with a body no longer get a 400. (#478)
Contributors
- @Railly
- @Umbranoxio
- @Tiancheng-Xu
- @ctate
- Nov 1, 2026
- Date parsed from source:Nov 1, 2026
- First seen by Releasebot:Nov 3, 2026
v0.15.13
portless adds unprivileged proxy mode for supported low ports and improves privilege checks when elevation fails.
New Features
Unprivileged proxy mode: Added
--unprivilegedandPORTLESS_UNPRIVILEGED=1to bind supported low ports without sudo, accept only loopback peers, and preserve the mode across restarts and service installation. (#529)Bug Fixes
Proxy privileges: Check whether the requested listener needs root before asking for sudo. If elevation fails, stop with an error instead of silently switching ports. (#528)
Documentation
Added shared technical writing guidance for documentation changes. (#524)
Contributors
- @Railly
- @ctate
- @bensabic
Similar to portless with recent updates:
- Claude Code updates494 release notes · Latest Nov 20, 2026
- ChatGPT updates255 release notes · Latest Nov 19, 2026
- Claude updates194 release notes · Latest Nov 17, 2026
- OpenAI updates314 release notes · Latest Nov 20, 2026
- Next.js updates135 release notes · Latest Nov 10, 2026
- Vercel updates738 release notes · Latest Nov 19, 2026
- Oct 26, 2026
- Date parsed from source:Oct 26, 2026
- First seen by Releasebot:Oct 27, 2026
v0.15.12
portless adds an MCP server with tools for routes, aliases, proxies, and diagnostics, plus VitePress and Wrangler support. It also improves npm exec option handling, misdirected request responses, and WSL-hosted container trust store behavior.
New Features
- MCP server: Added portless mcp with tool profiles for route lookup, static aliases, proxy management, and diagnostics. (#513)
- VitePress support: Inject the assigned port and bind address for VitePress dev, serve, and preview commands. (#508)
- Wrangler support: Inject the assigned port and --ip bind address for wrangler dev. (#509)
Bug Fixes
- npm exec framework flags: Pass injected framework options through npm exec and npm x after npm's option separator, while leaving ambiguous commands untouched. (#511)
- Misdirected requests: Return 421 for hostnames outside the configured TLDs instead of showing the app list, using HTML or JSON to match the client. (#512)
- WSL-hosted containers: Use the Linux trust store in containers that inherit a WSL2 kernel without Windows integration tools. (#507)
Contributors
- @lahfir
- @ericclemmons
- @KennyMcSimpson
- @alistair3149
- @corvus-vardelabs
- @desilvakai
- @tlq5l
- Oct 24, 2026
- Date parsed from source:Oct 24, 2026
- First seen by Releasebot:Oct 25, 2026
v0.15.11
portless fixes routing, certificate, and backend reliability issues while improving static alias handling, Astro options, Tailscale port assignment, and Windows helper behavior.
Bug Fixes
- Static aliases: Allow --force to replace a static alias without treating it as a running process, and explain when the alias must be re-added. (#476)
- Configuration source: Report whether the configured app name came from package.json or portless.json. (#490)
- Route liveness: Keep live routes when the current user lacks permission to signal their processes. (#498)
- Tailscale ports: Account for ports held by foreground serve and funnel sessions when assigning HTTPS ports. (#499)
- Astro global options: Inject the assigned port and host when global options appear before the Astro subcommand. (#500)
- Certificate scope: Reject TLS server names outside the configured TLDs or with invalid hostname characters, and limit new macOS CA trust to SSL. (#497)
- Certificate clock skew: Backdate CA, server, and host certificates by five minutes on OpenSSL 3.4 or newer so clients with slightly slower clocks can connect. (#501)
- Windows helper processes: Hide console windows for OpenSSL and other helper commands when running without a terminal. (#502)
- Backend failures: Drain the remaining request body after a backend error so client connections do not stall. (#489)
Contributors
- @lahfir
- @tlq5l
- @bercedev
- @sensei-woo
- @gyanu2507
- @snomiao
- @arturo-tikamaru
- Oct 23, 2026
- Date parsed from source:Oct 23, 2026
- First seen by Releasebot:Oct 24, 2026
v0.15.10
portless fixes Apple TLS certificate rejection, returns JSON proxy errors to non-HTML clients, and rejects malformed ports across configuration sources.
Bug Fixes
- Host certificates: Omit invalid sibling wildcard names from two-label host certificates and regenerate cached certificates that contain them, fixing TLS rejection on Apple platforms. (#491)
- Proxy error responses: Return JSON for portless-generated 404, 502, and 508 errors when the client does not accept HTML. (#485)
- Port validation: Reject malformed port values instead of accepting leading digits across CLI flags, environment variables, aliases, and service configuration. (#493)
Contributors
- @lahfir
- @BlvckParrot
- @BetterAndBetterII
- Oct 22, 2026
- Date parsed from source:Oct 22, 2026
- First seen by Releasebot:Oct 23, 2026
v0.15.9
portless adds Cloudflare quick tunnels for public app URLs, route uptime visibility, improved 404 app-list filtering, and URL hostname fixes.
New Features
- Added Cloudflare quick tunnels with --cloudflare to share apps through a public URL (#480)
- Added route uptime to the proxy app list and portless list (#472)
- Added hostname filtering and a newest-first toggle to the proxy's 404-page app list (#473, #474)
Bug Fixes
- Fixed uppercase URL schemes so HTTP and HTTPS prefixes are removed correctly from hostnames (#484)
Contributors
- @lahfir
- @kumburovicbranko682-boop
- Oct 13, 2026
- Date parsed from source:Oct 13, 2026
- First seen by Releasebot:Oct 14, 2026
v0.15.8
portless fixes process cleanup so closing terminals, pruning crashed sessions, and exiting or force-killing commands stop dev servers and child processes, including Turbo workflows on Windows.
Bug Fixes
- Terminal close cleanup: Closing the terminal now stops dev servers launched directly, through Turbo, or in multi-app mode instead of leaving them running on their ports. (#450)
- Crashed session cleanup: portless run and portless prune now stop orphaned command process groups from crashed sessions, including descendants outside the route port, while checking process identity before signaling. (#451)
- Windows command cleanup: Normal exits and force-kills now terminate the command tree, including Turbo and its dev servers, so orphaned processes no longer keep consuming shell input. (#438)
Contributors
@Railly
Original source - Oct 2, 2026
- Date parsed from source:Oct 2, 2026
- First seen by Releasebot:Oct 2, 2026
v0.15.7
portless adds Turbo JSONC workspace support, warns when hostnames still do not resolve, and brings WebMCP docs access for agents. It also improves hosts sync, wildcard routing, port checks, and proxy stability while fixing CA certificate and version manager issues.
New Features
- Turbo JSONC workspaces: Workspaces that only have turbo.jsonc now use Turbo orchestration, the same as turbo.json. (#422)
- Unresolved hostname warning: After registering a route, portless asks the proxy to sync the hosts file and warns when the hostname still does not resolve. (#374)
- WebMCP documentation site: The docs moved to Geistdocs and expose their pages to agents through WebMCP. (#427)
Bug Fixes
- Hosts sync data loss: Manual hosts sync refuses to write when the hosts file cannot be read, verifies what it wrote, and removes stale managed entries when no routes remain. (#424)
- Local CA certificate: The generated CA no longer carries a duplicate Basic Constraints extension on OpenSSL 1.1.1 and LibreSSL, which macOS and OpenSSL 3 rejected and left *.localhost untrusted. (#443)
- Proxy crash on backend restart: The proxy no longer forwards client hop-by-hop headers, which left backend sockets open and crashed the proxy with ECONNRESET when a backend restarted. (#445)
- Wildcard fallback order: With --wildcard, an unregistered subdomain now routes to the most specific registered parent instead of the first one stored. (#446)
- Occupied app ports: Free app ports are checked on 127.0.0.1, ::1, 0.0.0.0 and ::, so portless no longer assigns a port another server already holds. (#447)
- Version manager node: Child commands now use the node a version manager put first on PATH; portless's own node directory is only a fallback. (#448)
Contributors
- @Railly
- @ctate
- @Knat-Dev
- @EfeDurmaz16
- @octo-patch
- @bilinkis
- @luizfm
- @Geektrovert
- @thazhemadam
- @begininvoke
- Aug 24, 2026
- Date parsed from source:Aug 24, 2026
- First seen by Releasebot:Aug 24, 2026
v0.15.6
portless adds agent-readable documentation with clean Markdown pages and an llms.txt index, and improves Windows startup, package-script port handling, and Ctrl+C process cleanup for more reliable behavior.
New Features
Agent-readable documentation: The documentation site now exposes clean Markdown pages and an llms.txt index so agents can discover and consume the docs directly. (#387)
Bug Fixes
Framework flags through package scripts: Frameworks that ignore PORT now receive the assigned --port and --host flags when launched through supported package-manager scripts, while non-server and unsafe scripts are left untouched. (#366)
Windows service lifetime: The Windows startup service now registers a UTF-16 Task Scheduler definition with no execution time limit and replaces existing tasks atomically. (#381)
Ctrl+C process cleanup: Interrupt handling now waits for the command's process tree to exit and terminates remaining descendants after a short grace period. (#385)
Contributors
@Railly
@EfeDurmaz16
@JohnPhamous
Original source - Jul 30, 2026
- Date parsed from source:Jul 30, 2026
- First seen by Releasebot:Aug 1, 2026
v0.15.5
portless fixes custom multi-segment TLDs and improves WebSocket proxying over HTTP/2, restoring dev server HMR for h2 browsers and handling handshake failures more cleanly.
Bug Fixes
Multi-segment custom TLDs: --tld and PORTLESS_TLD now accept dotted DNS names such as dev.example.com, so local URLs can mirror production structure. validateTld checks per-label DNS rules and the 253-character total limit, overlapping TLDs resolve by longest match, and cert cache filenames stay under the filesystem name limit for long hostnames. (#365)
WebSocket over HTTP/2: Proxy now advertises RFC 8441 extended CONNECT and bridges :protocol websocket streams to an HTTP/1.1 upgrade against the backend, fixing dev server HMR for browsers that negotiate h2 over ALPN. Plain-HTTP upgrades on the TLS port are proxied instead of dropped, and a backend that rejects the handshake or answers with a bad Sec-WebSocket-Accept now gets a 502 instead of a silently destroyed socket. (#363)
Contributors
@Railly
@KingPsychopath
@erichurkman
@sanjevirau
Original source - Jul 16, 2026
- Date parsed from source:Jul 16, 2026
- First seen by Releasebot:Jul 17, 2026
v0.15.4
portless fixes loopback-only proxy binding to keep routes local outside LAN mode.
Bug Fixes
Loopback-only proxy binding: Outside LAN mode, the proxy and HTTP redirect listeners now bind only to 127.0.0.1 and ::1, so Portless routes cannot be reached through LAN, VPN, or other network interfaces. LAN mode still binds to all interfaces explicitly. (#361)
Contributors
@ctate
Original source - Jul 14, 2026
- Date parsed from source:Jul 14, 2026
- First seen by Releasebot:Jul 15, 2026
v0.15.3
portless fixes sudo state sharing and improves Windows and WSL CA trust cleanup for safer retries.
Bug Fixes
State directory under sudo: Portless now resolves per-user state from the original sudo user's home, so an elevated proxy and unprivileged app processes share the same routes instead of writing to separate state directories. (#357)
Windows and WSL CA trust: On WSL, portless trust now installs the local CA in both Linux and Windows trust stores, while portless clean removes the exact certificate from both. Failed trust-store cleanup preserves the CA identity for safe retries, including on native Windows. (#357)
Contributors
@ctate
@gerardbalaoro
Original source
Curated by the Releasebot team
Releasebot is an aggregator of official product update announcements from hundreds of software vendors and thousands of sources.
Our editorial process involves the manual review and audit of release notes procured with the help of automated systems.