rendezvousLINUX PREVIEW · 0.2.1
Your first rendezvous.
Run the host on the machine you want to share. Run the client where your agent executes commands. Use the same commands for your first session and every session after it.
1. Start the host
curl -fsSL https://host.rdzv.sh | sh
The bootstrap selects the current release, downloads and verifies it when needed, and starts a host session. A matching local copy is reused quietly.
Share the highlighted rv1.… invitation privately with your agent. Keep the host running. It displays Connected. when the guest authenticates. This is a new shell under your account, not a sandbox.
2. Join
curl -fsSL https://join.rdzv.sh | sh
Paste the invitation at the prompt. For automation, supply an owner-only invitation file using the same bootstrap:
curl -fsSL https://join.rdzv.sh | sh -s -- --invitation-file /private/path/invitation --command 'uname -a'
3. End access
Exit the remote shell, press Ctrl-C on the host, or let the session deadline expire. The first successful authentication consumes the invitation. Disconnect never reactivates it. One interactive connection can run many commands; --command runs one command and ends that session.
curl -fsSL https://host.rdzv.sh | sh -s -- --invite-timeout 300 --session-timeout 1800
Defaults are ten minutes to redeem and one hour of access after redemption. A new host invocation creates new service identities and credentials.
Supported environment
- Linux x86_64 with glibc 2.34 or newer: for example, Ubuntu 22.04+, Debian 12+, or Amazon Linux 2023. These are compatibility examples, not a claim that every distribution has been tested.
- Base command-line utilities:
curl,tar,sha256sum,getconf, and standard shell utilities. - A writable home directory on a filesystem that permits execution. No root or sudo is required.
- The bundled Python interpreter and Tor are used even if your system has neither installed. Runtime dependencies are delivered from this service, not fetched from PyPI on the endpoint.
- ARM, macOS, Windows, older glibc, and musl-based hosts such as Alpine are not packaged in this release. Unsupported platforms stop before installation instead of asking for elevation.
- No SFTP, port forwarding, persistent shell service, or automatic reconnect.
Inspect before installing
Read the shell installer or download it first:
curl -fsSLo install-rdzv.sh https://host.rdzv.sh/install less install-rdzv.sh sh install-rdzv.sh
Read the application and packaging source and bundle manifest. The runtime archive is delivered in fixed-size parts, joined locally, and verified as a whole before extraction. The installer's checksum is served by the same publisher; this is integrity checking, not an independent signature.
Provider deployment
If a custom domain is still awaiting activation, these endpoints serve the same bootstrap:
curl -fsSL https://connect.rdzv.net/host | sh curl -fsSL https://connect.rdzv.net/join | sh
The rendezvous.fernando-eb7.workers.dev deployment also supports /host, /join, and /install. The website distributes software; shell traffic travels through Tor.
Caching, updates, and removal
Every invocation of the website command fetches the current bootstrap. Releases are cached under ~/.local/share/rendezvous; ongoing sessions retain their existing runtime. Optional local launchers are also cached, but running them directly does not check for updates. No shell configuration is required for the website commands.
To remove the cached files, stop your sessions and remove ~/.local/share/rendezvous, ~/.local/bin/rdzv, and ~/.local/bin/rendezvous.
Troubleshooting
- Onion connection failed: Tor publication can take time. Retry before the invitation expires if authentication has not succeeded.
- Permission denied after connecting once: start a new host session; the previous invitation is consumed.
- Execution denied under home: local policy or a no-execute filesystem can prevent running the bundle. The installer does not bypass that policy.
- Unsupported platform: no system packages are changed and no privilege prompt is attempted.