Skip to content

installation.md

Latest commit

 

History

History
149 lines (106 loc) · 4.17 KB

installation.md

File metadata and controls

149 lines (106 loc) · 4.17 KB
Raw
title Install Rootform
description Install Rootform on macOS, Linux, or Windows, or run it from a container.

Choose your platform, install Rootform, then verify the executable. Embedded Dialects are included and need no additional Rootform configuration for your first architecture.

Check provider coverage for interpreted types, provider bindings and input limits before choosing a runtime.

Recommended

curl -fsSL https://rootform.dev/install | sh

Verify

rootform version

Other options

Homebrew:

brew install rootform-dev/tap/rootform

Recommended

curl -fsSL https://rootform.dev/install | sh

Verify

rootform version

Recommended

Invoke-RestMethod https://rootform.dev/install.ps1 | Invoke-Expression

Verify

rootform version

Recommended

docker pull ghcr.io/rootform-dev/rootform:0.3.0

Verify

docker run --rm ghcr.io/rootform-dev/rootform:0.3.0 rootform version

Container usage

Manual installation

Use a release archive when you need exact binary bytes, checksum evidence, or a transfer to a machine without network access. From Rootform releases, select a published product version and take its platform archive and SHA256SUMS. The filenames below show archive conventions; use the selected release's version in each name. A verification runtime is for contributor checks and does not provide a product installation.

Platform Archive
macOS, Apple silicon rootform_0.3.0_darwin_arm64.tar.gz
macOS, Intel rootform_0.3.0_darwin_amd64.tar.gz
Linux, x86-64 rootform_0.3.0_linux_amd64.tar.gz
Linux, ARM64 rootform_0.3.0_linux_arm64.tar.gz
Windows, x86-64 rootform_0.3.0_windows_amd64.zip

Release archives include binary license and third-party notices. Match the archive against its SHA256SUMS entry before extraction:

shasum -a 256 rootform_0.3.0_darwin_arm64.tar.gz
sha256sum rootform_0.3.0_linux_amd64.tar.gz
Get-FileHash .\rootform_0.3.0_windows_amd64.zip -Algorithm SHA256

Extract the .tar.gz or .zip, then place rootform or rootform.exe in a directory on PATH. Run rootform version to confirm the executable.

To run a container, pin the image by index digest instead of using an archive. See Container usage. For a disconnected project, prepare exact third-party Dialects and Policy Packs as described in Locks and vendored content.

Update or remove Rootform

Update package-managed installations with their package managers:

  • Homebrew: brew upgrade rootform-dev/tap/rootform
  • Shell installer: run the recommended install command again. It replaces the executable in the same installation directory.
  • Manual archive: replace the executable with the binary from the new release, then verify it with rootform version.
  • Container: pull the selected release tag again, for example docker pull ghcr.io/rootform-dev/rootform:0.3.0.

Remove package-managed installations with:

  • Homebrew: brew uninstall rootform-dev/tap/rootform
  • Shell installer: remove ~/.local/bin/rootform by default, or the file under the custom ROOTFORM_INSTALL_DIR.
  • Manual archive: remove rootform or rootform.exe from its PATH directory.
  • Container: docker image rm ghcr.io/rootform-dev/rootform:0.3.0.

These steps remove the executable or image. rootform uninstall removes installed Dialects or Policy Packs from $ROOTFORM_HOME; it does not remove the executable. See the uninstall command reference.

Continue with the quickstart to analyze a sample plan, or analyze your own plan or state right away.