Skip to content

Commit

Permalink
install_software_with_appimage.md (#2311)
Browse files Browse the repository at this point in the history
* install_software_with_appimage.md

Grammar Check

* Update install_software_with_appimage.md

---------

Co-authored-by: sspencerwire <[email protected]>
  • Loading branch information
gannazhyrnova and sspencerwire authored Aug 28, 2024
1 parent 1a135c4 commit efedf9b
Showing 1 changed file with 16 additions and 16 deletions.
32 changes: 16 additions & 16 deletions docs/desktop/appimage/install_software_with_appimage.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
---
title: Install Software with AppImage
title: Install Software with an AppImage
author: Joseph Brinkman
contributors: Steven Spencer
contributors: Steven Spencer, Ganna Zhyrnova
---

## Introduction

AppImages are a convenient way to install software on Linux without using package managers or the command line. They are single-file executables that contain all the program's dependencies, making them easy to run on various Linux distributions. Installing software with an AppImage may serve as a simpler and more straightforward process than managing repositories or building from source for end-users that are already familiar with Windows and Mac operating systems.
AppImages are a convenient way to install software on Linux without using package managers or the command line. They are single-file executables that contain all the program's dependencies, making them easy to run on various Linux distributions. For end-users familiar with Windows and Mac operating systems, installing software with an AppImage may be more straightforward than managing repositories or building from source.

Installing programs on your Rocky Linux desktop with AppImage is a three step process:
Installing programs on your Rocky Linux desktop with AppImage is a three-step process:

1. Download the desired program's AppImage
2. Make the program executable
3. Run the program to install it

The example program used in this guide is Krita. You will download and install using AppImage. Krita is a free and open source graphic design software. Since this guide is about the functions of AppImage, there are no details on the use of Krita. You can [read more about it on their website](https://krita.org/).
The example program used in this guide is Krita. You will download and install it using an AppImage. Krita is a free and open-source graphic design software. Since this guide is about the functions of AppImage, there are no details on using Krita. You can [read more about it on their website](https://krita.org/).

## Assumptions

Expand All @@ -25,27 +25,27 @@ For this guide, you need the following:

## Downloading a Program's AppImage

The first step of installing software using an AppImage is downloading the program's AppImage. To download the Krita AppImage, go to the [Download](https://krita.org/en/download/) page, and click the `Download` button.
The first step of installing software using an AppImage is downloading the program's AppImage. To download the Krita AppImage, go to the [Download](https://krita.org/en/download/) page and click the `Download` button.

![Click download appimage button](images/download_krita_appimage.webp)

## Installing a Program using its AppImage

After downloading the AppImage, you will need to navigate to the `Downloads` folder to make the file executable before running it.
After downloading the AppImage, you must navigate to the `Downloads` folder to make the file executable before running it.

In the top left corner of your Rocky Linux desktop, click Activities:

![Rocky linux deskop with default wall paper. The mouse is hovered over the activities button.](images/activites_appimage.webp)
![Rocky Linux desktop with default wallpaper. The mouse is hovered over the activities button.](images/activites_appimage.webp)

Once the activities panel launches, type 'files' into the search field. Click the Files app:

![Activites pane on a Rocky linux system. 'Files' is typed into the search field. The Files app is hovered over.](images/searchbar_files_appimage.webp)
![Activites pane on a Rocky Linux system. 'Files' is typed into the search field. The Files app is hovered over.](images/searchbar_files_appimage.webp)

Files will launch in the home directory. Click the Downloads folder:

![The Files app is open and the mouse is hovered over the Downloads folder.](images/files_downloads_appimage.webp)
![The Files app is open, and the mouse is hovered over the Downloads folder.](images/files_downloads_appimage.webp)

Now that you have navigated to the directory that the AppImage is in, it is time to make the program executable. Right-click the AppImage file and select properties:
Now that you have navigated to the AppImage directory, it is time to make the program executable. Right-click the AppImage file and select properties:

![The AppImage file is selected. The mouse is hovered over properties.](images/file_properties_appimage.webp)

Expand All @@ -57,7 +57,7 @@ Select the checkbox labeled 'Execute' before closing the properties menu:

![The checkbox labeled 'Execute' has been selected](images/file_properties_allow_executing_file_as_program_appimage.webp)

If you would rather use the command line, open terminal and run the following command to make the AppImage executable:
If you would instead use the command line, open the terminal and run the following command to make the AppImage executable:

```bash
sudo chmod a+x ~/Downloads/krita*.appimage
Expand All @@ -69,22 +69,22 @@ You have reached the final step - running your AppImage!

!!! Note

Running an AppImage does not install the program into your system's files like traditional software packages do. What this means is that everytime you want to use the program you will need to double-click the AppImage. It is important to store the AppImage in a safe and memorable place for this reason.
Running an AppImage does not install the program into your system's files like traditional software packages do. This means that whenever you want to use the program, you must double-click the AppImage. For this reason, it is important to store the AppImage in a safe and memorable place.

Double-click the AppImage:

![The AppImage is selected indicating it was double-clicked and ran](images/run_app_image.webp)
![The AppImage is selected, indicating it was double-clicked and ran](images/run_app_image.webp)

You can alternatively run the following shell command instead of double-clicking the AppImage:

```bash
./krita*.appimage
```

Shortly after running the AppImage, Krita will launch!
Shortly after running the AppImage, Krita will launch.

![The Krita app launcher](images/krita_launching.webp)

## Conclusion

This guide taught you how to download and use a program with an AppImage. AppImage's are convenient for end-users because they do not need to know how to manage repositories, build from source, or use the command line to use their favorite programs that have an available AppImage.
This guide taught you how to download and use a program with an AppImage. AppImages are convenient for end-users because they do not need to know how to manage repositories, build from source, or use the command line to use their favorite programs with an available AppImage.

0 comments on commit efedf9b

Please sign in to comment.