Install & set up
Getting a working tovio binary and your first repository.
- Install TOVIO by building from sourceThe supported install path today: toolchain, build, PATH, verify โ and what the lean build actually costs you.
- What you need before you buildThe Rust toolchain, and the per-platform prerequisites โ including the two things you have probably been told you need and do not.
- Supported platforms and minimum versionsAll six release targets, the OS floor and key storage for each, and what the declared-not-certified distinction actually commits to.
- Confirm TOVIO installed correctlyWhat a healthy first run looks like, line by line, and the two error codes you might meet on the way.
- Install shell completionsTab completion for bash, zsh, fish, PowerShell and elvish.
- Create your first repositorytovio init, the three collaboration modes, what lands on disk, and how to move from Simple to Team later.
- Take the guided tourtovio quickstart, its five topics, and the scratch repository it works in.
- Find help inside the CLItovio help, the three command tiers, --json, and how to read a TVO error code.
- Install on macOS with a packageThe pkg and tarball install, once signed packages publish.
- Install on Linux with deb or rpmPackage install for Debian/Ubuntu and RPM distributions, once signed packages publish.
- Install on WindowsThe Windows installer path, once signed packages publish.
- Verify a downloaded releaseChecking the checksum, the build-provenance attestation, and the platform signature before you install.
- Run TOVIO on a headless host or CI runnerThere is no on-disk fallback when the OS keychain is missing โ here is what to set, and the fail-closed rules around it.
- When the build failsThe failure modes of a source build, what each one actually means, and the one that shows up a command late.
- Upgrade a source buildRebuilding onto a newer version, and what does and does not need migrating.
- Uninstall TOVIO and remove local stateEverything TOVIO writes outside its own binary, and the order to remove it in.