🚀 Getting Started

Important

The most popular way to use ACORN is to not install it at all — simply leverage the power and promise of ACORN within a CI job (see this example .gitlab-ci.yml)

Installation

Install with Scoop (Windows only)

Warning

🚧 Under construction (Pull Request/Issue)

• Ensure you have Scoop installed.

• Open your terminal and add the extras bucket to Scoop

  scoop bucket add extras
  

• Run the following command to install ACORN

  scoop install acorn
  

• After installation, you can verify the installation by running:

  acorn help
  

Install with Homebrew (Linux and MacOS)

Warning

🚧 Under construction

Install with Cargo

• Ensure you have Rust and Cargo installed. If not, you can install them using rustup.rs.

• Open your terminal and run the following command to install ACORN

  cargo install acorn-cli
  

• After installation, you can verify the installation by running:

  acorn help
  

Run Inside a Container

• Ensure you have Docker¹ installed.

• Pull the latest ACORN image with Docker¹

  docker pull savannah.ornl.gov/research-enablement/acorn/runner
  

• Run ACORN using Docker¹

  docker run --rm savannah.ornl.gov/research-enablement/acorn/runner help
  

Tip

You will probably need to mount a volume to use ACORN with your local files. For example:

docker run --rm -v $(pwd):/data savannah.ornl.gov/research-enablement/acorn/runner:latest check /data/project

Download pre-compiled binary

• Download the latest release from the ACORN GitHub Releases

  • 🪟 Windows

    • Open a PowerShell terminal and run:

      irm -OutFile acorn.exe -Uri https://code.ornl.gov/api/v4/projects/16689/packages/generic/x86_64-pc-windows-gnu/v0.1.50/acorn.exe
      

    • Test the downloaded executable:

      .\acorn.exe help
      

  • 🐧 Linux

    • Open a terminal and run:

      curl -LO https://code.ornl.gov/api/v4/projects/16689/packages/generic/x86_64-unknown-linux-musl/v0.1.45/acorn
      

    • Make the downloaded file executable:

      chmod +x acorn
      

    • Test the downloaded executable:

      acorn help
      

  • 🍎 MacOS

    🚧 Under construction

Tip

Move the binary to a directory included in your system’s PATH for system-wide access.

Install from source

• Clone the ACORN repository

  git clone https://code.ornl.gov/research-enablement/acorn.git
  cd acorn
  

• Install acorn command

  cargo install --path ./acorn-cli
  

• After installation, you can verify the installation by running:

  acorn help
  

1. These instructions will work with any OCI-compliant container runtime, such as Docker or Podman. ↩ ↩2 ↩3