Skip to content

Add Arch Linux installation guide #92

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 11, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,5 +14,6 @@ Pick the installation guide for your system:
- [Ubuntu](installation/ubuntu.html)
- [Fedora](installation/fedora.html)
- [Debian](installation/debian.html)
- [Arch Linux](installation/arch.html)

If your operating system is not listed above, use the [Docker installation guide](installation/docker.html).
106 changes: 106 additions & 0 deletions installation/arch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,106 @@
---
title: Installation on Arch Linux
layout: home
nav_exclude: true
---

# Installation on Arch Linux

{: .fs-8 .fw-700 .text-center }

Arch Linux users can install the PSP SDK using packages available in the Arch
User Repository (AUR). There are two primary options: a pre-compiled binary
package (recommended for faster installation) and a source package (which builds
the SDK locally).

## Prerequisites

{: .fs-6 .fw-700 }

### AUR Helper (Optional but Recommended)

An AUR helper (like `yay`, `paru`, etc.) simplifies installing and updating AUR
packages. If you don't have one, you can find instructions on the
[Arch Wiki's AUR helpers page](https://wiki.archlinux.org/title/AUR_helpers).
Using an AUR helper is assumed for the simplified commands below, but manual
installation steps are also provided.

## Installation via AUR (Recommended - Binary)

{: .fs-6 .fw-700 }

The [`psp-sdk-bin`](https://aur.archlinux.org/packages/psp-sdk-bin) package,
provides pre-compiled binaries for the PSP SDK, making installation much faster.

**Using an AUR helper (e.g., `yay`):**

```shell
yay -S psp-sdk-bin
```

**Manual Installation:**

```shell
# Clone the build files
git clone https://aur.archlinux.org/psp-sdk-bin.git
cd psp-sdk-bin

# Build and install the package
makepkg -si

# Clean up (optional)
cd ..
rm -rf psp-sdk-bin
```

## Installation via AUR (Alternative - Source)

{: .fs-6 .fw-700 }

The [`psp-sdk`](https://aur.archlinux.org/packages/psp-sdk) package builds the
entire SDK from source. This takes significantly longer but ensures you are
building against your system's exact libraries.

**Warning:** Building the full SDK can take a considerable amount of time and
CPU resources.

**Using an AUR helper (e.g., `yay`):**

```shell
yay -S psp-sdk
```

**Manual Installation:**

```shell
# Clone the build files
git clone https://aur.archlinux.org/psp-sdk.git
cd psp-sdk

# Build and install the package (this will take a while!)
makepkg -si

# Clean up (optional)
cd ..
rm -rf psp-sdk
```

## Verification

{: .fs-6 .fw-700 }

From a new terminal, run the following command to confirm the SDK is found and
the environment variable is set:

```shell
psp-config --pspdev-path
```

This command should output the path you set for `PSPDEV` (e.g., `/opt/pspdev`).
If the command itself is not found, ensure `/opt/pspdev/bin` (or the equivalent
`bin` directory for your installation) is in your `PATH`. The profile script
installed by the AUR package should handle this automatically after logging out
and back in or rebooting.

That's it, now the PSP SDK can be used to build PSP software. Check out the
[How to Use](../how_to_use.html) page for a guide on how to do so.