Skip to content

How To Install And Use An AppImage

After downloading the AppImage, it won’t be executable by default. You need to change its permissions to make it executable.

Terminal window
cd ~/Downloads
chmod +x Obsidian-1.6.7.AppImage

Once the AppImage is executable, you can run it directly from the terminal or by double-clicking it in your file manager.

Terminal window
./Obsidian-1.6.7.AppImage

Step 4: Optionally Move the AppImage to a System-Wide Directory

Section titled “Step 4: Optionally Move the AppImage to a System-Wide Directory”

If you plan to use the application frequently, you may want to move the AppImage to a system-wide directory like /opt for easier management.

  1. Create a Directory:

    Terminal window
    sudo mkdir -p /opt/obsidian
  2. Move the AppImage:

    Terminal window
    sudo mv ~/Downloads/Obsidian-1.6.7.AppImage /opt/obsidian/Obsidian.AppImage

To integrate the AppImage into your application launcher (so you can search for it like any other installed app), you’ll need to create a .desktop file.

  1. Create a .desktop File:

    Open a text editor and create a file named obsidian.desktop in ~/.local/share/applications/:

    Terminal window
    nano ~/.local/share/applications/obsidian.desktop
  2. Add the Following Content:

[Desktop Entry]
Type=Application
Name=Obsidian
Icon=/opt/obsidian/obsidian.png
Exec=/opt/obsidian/Obsidian.AppImage
Categories=Utility;Editor;
Terminal=false
MimeType=x-scheme-handler/obsidian;
Make sure to adjust the paths to match the location of your AppImage and icon.
3. **Update Desktop Database**:
After saving the file, run the following command to ensure your system recognises the new desktop entry:
```bash
update-desktop-database ~/.local/share/applications/
  1. Log Out and Back In:

    If the application doesn’t appear in your launcher immediately, try logging out and back in.