roc/getting_started/linux_x86_64.md

Roc installation guide for x86_64 Linux systems

How to install Roc

In order to develop in Roc, you need to install the Roc CLI, which includes the Roc compiler and some helpful utilities.

1. Download the latest nightly from the assets here.

2. Untar the archive:

   tar -xf roc_nightly-linux_x86_64-<VERSION>.tar.gz
   cd roc_night<TAB TO AUTOCOMPLETE>
   

3. To be able to run the roc command anywhere on your system; add the line below to your shell startup script (.profile, .zshrc, ...):

   export PATH=$PATH:~/path/to/roc_nightly-linux_x86_64-<VERSION>
   

4. Check everything worked by executing roc version

How to install Roc platform dependencies

This step is not necessary if you only want to use the basic-cli platform, like in the tutorial. But, if you want to compile Roc apps with other platforms (either in examples/ or in your own projects), you'll need to install one or more of these platform languages too.

1. Install the Rust compiler, for apps with Rust-based platforms:

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

2. For Zig-based platforms: download zig 0.9.1, extract the archive and add export PATH=$PATH:~/path/to/zig to your shell startup script (.profile, .zshrc, …).

3. Install a C compiler, for apps with C-based platforms:

   # On a Debian-based distro like Ubuntu
   sudo apt update && sudo apt install build-essential clang
   
   # On an RPM-based distro like Fedora
   sudo dnf check-update && sudo dnf install clang
   

   # Note: If you installed Rust in this terminal session, you'll need to open a new one first!
   ./roc examples/platform-switching/rocLovesRust.roc
   
   ./roc examples/platform-switching/rocLovesZig.roc
   
   ./roc examples/platform-switching/rocLovesC.roc