roc/getting_started/linux_x86.md

0. Download the latest nightly from the assets here.
1. Untar the archive:

   tar -xf roc_nightly-linux_x86_64-<VERSION>.tar.gz
   

2. Some fresh installs require executing sudo apt update, it is not needed to execute sudo apt upgrade after this.
3. To be able to run examples:
   • for the Rust example:

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

   • for the zig example:

   wget https://ziglang.org/download/0.8.1/zig-linux-x86_64-0.8.1.tar.xz
   tar -xf zig-linux-x86_64-0.8.1.tar.xz
   sudo ln -s  $(pwd)/zig-linux-x86_64-0.8.1/zig /usr/local/bin/zig
   

   • for the C example:

   sudo apt install build-essential clang
   

4. Run examples with:

   # Rust. If you installed rust in this terminal you'll need to open a new one first!
   ./roc examples/hello-world/rust-platform/helloRust.roc
   # Zig
   ./roc examples/hello-world/zig-platform/helloZig.roc --linker=legacy
   # C
   ./roc examples/hello-world/c-platform/helloC.roc --linker=legacy
   

5. See here for the other examples.

Tip: when programming in roc, we recommend to execute ./roc check myproject/Foo.roc before ./roc myproject/Foo.roc or ./roc build myproject/Foo.roc. ./roc check can produce clear error messages in cases where building/running may panic.