# Linux

### Option 1: PPA

Run the following commands in a terminal

```bash
sudo add-apt-repository ppa:andrescv/jupiter
sudo apt-get update
sudo apt-get install jupiter
```

### Option 2: Deb Package

You need to download the debian package:

{% file src="/files/-LpTcRW7edySvLRZZY-6" %}
Jupiter deb package
{% endfile %}

Then run the following command in a terminal

```bash
sudo dpkg -i jupiter_3.1_amd64.deb
```

### Option 3: App Image

You need to download the app image from [here](https://github.com/andrescv/Jupiter/releases/download/v3.1/Jupiter-3.1-linux.zip) and run the following commands

```bash
unzip Jupiter-3.1-linux.zip
sudo mv image /opt/jupiter
```

### Option 4: Build from Source

You have to install Java 11 in order to build Jupiter from source:

```bash
sudo add-apt-repository ppa:linuxuprising/java
sudo apt-get update
sudo apt-get install oracle-java11-installer
```

Then clone the repository:

```bash
git clone https://github.com/andrescv/Jupiter.git
```

To create the app image, just run the following:

```bash
./gradlew jlink
```

The previous command will create a **build** directory, inside that directory you will find a directory called **image** that contains the Jupiter app. You can start Jupiter using the following command:

```bash
./build/image/bin/jupiter
```

### Verify Installation

To verify that you successfully install Jupiter, please run the following command in a terminal

```bash
jupiter -v
```

you should see the following output

```bash
        __          _ __         
    __ / /_ _____  (_) /____ ____
   / // / // / _ \/ / __/ -_) __/
   \___/\_,_/ .__/_/\__/\__/_/
           /_/                   

RISC-V Assembler & Runtime Simulator
               v3.1
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://jupitersim.gitbook.io/jupiter/installation/linux.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.