mirror of
https://github.com/roc-lang/roc.git
synced 2025-09-26 21:39:07 +00:00
61 lines
2.1 KiB
Markdown
61 lines
2.1 KiB
Markdown
# 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 various helpful utilities.
|
|
|
|
1. Download the latest nightly from the assets [here](https://github.com/roc-lang/roc/releases).
|
|
|
|
1. Untar the archive:
|
|
|
|
```sh
|
|
tar -xf roc_nightly-linux_x86_64-<VERSION>.tar.gz
|
|
cd roc_night<TAB TO AUTOCOMPLETE>
|
|
```
|
|
|
|
1. To be able to run the `roc` command anywhere on your system; add the line below to your shell startup script (.profile, .zshrc, ...):
|
|
```sh
|
|
export PATH=$PATH:~/path/to/roc_nightly-linux_x86_64-<VERSION>
|
|
```
|
|
|
|
1. 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](https://github.com/roc-lang/basic-cli), like in the tutorial.
|
|
But, if you want to compile Roc apps with other platforms (either in [`examples/`](https://github.com/roc-lang/roc/tree/main/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:
|
|
|
|
```sh
|
|
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
|
|
```
|
|
|
|
1. Install the Zig compiler, for apps with Zig-based platforms:
|
|
|
|
```sh
|
|
wget https://ziglang.org/download/0.9.1/zig-linux-x86_64-0.9.1.tar.xz
|
|
tar -xf zig-linux-x86_64-0.9.1.tar.xz
|
|
sudo ln -s $(pwd)/zig-linux-x86_64-0.9.1/zig /usr/local/bin/zig
|
|
```
|
|
|
|
1. Install a C compiler, for apps with C-based platforms:
|
|
|
|
```sh
|
|
# 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
|
|
```
|
|
|
|
```sh
|
|
# 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
|
|
```
|