Skip to content

Document Arch release candidate status #67

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.

Sign up for GitHub

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
ClaudiuSchuster merged 1 commit into from
Aug 29, 2026
Merged

Document Arch release candidate status #67

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
25 changes: 19 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -82,12 +82,12 @@ when needed; writes remain protected in the local VFS cache until uploaded.
## Install

The supported target is Linux Mint 22.x with Cinnamon, Nemo and a normal
graphical login. Arch Linux and Ubuntu are the first portability targets, but
are not called supported until their native packages and clean-desktop release
gates pass. An Arch package candidate now builds from the shared staged install
tree; it is not a published release yet. See the
[distribution portability plan](docs/PORTABILITY.md) and the
privacy-safe [real desktop release gates](docs/DESKTOP_GATES.md).
graphical login. Arch Linux and Ubuntu are the first portability targets. The
Arch Linux `0.8.0-1` package candidate has passed its clean Cinnamon/X11
desktop gate and is attached to the `v0.8.0` GitHub Release for configured
real-world review; it is not yet a generally supported Arch target. See the
[distribution portability plan](docs/PORTABILITY.md) and the privacy-safe
[real desktop release gates](docs/DESKTOP_GATES.md).

```bash
git clone https://github.com/oss-singularity/proton-drive-linux.git
Expand All @@ -96,6 +96,19 @@ cd proton-drive-linux
pdrive-ui
```

Arch reviewers can download the `proton-drive-linux-0.8.0-1-any.pkg.tar.zst`
asset from the [`v0.8.0` release](https://github.com/oss-singularity/proton-drive-linux/releases/tag/v0.8.0),
verify the SHA-256 published in its release notes and install it with:

```bash
sudo pacman -U ./proton-drive-linux-0.8.0-1-any.pkg.tar.zst
pdrive-ui
```

The native package installs immutable application files below `/usr` while
credentials, configuration, state, rclone and every VFS cache namespace remain
inside the user profile.

The installer may request `sudo` once to create the owner-only `/pdrive`
directory. On first launch, the setup wizard checks prerequisites, can install
missing supported distribution packages through Polkit, prepares PDrive's
Expand Down
10 changes: 10 additions & 0 deletions docs/DESKTOP_GATES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -122,3 +122,13 @@ Promotion requires green repository checks, the rolling Arch container job and
one complete clean Arch desktop record. A report from an already customized
machine is useful additional evidence but does not replace the clean install.
Ubuntu follows the same process with its own package and clean Ubuntu desktop.

The first clean Arch record was completed for pull request
[`#66`](https://github.com/oss-singularity/proton-drive-linux/pull/66): the
commit-bound `0.8.0-1` package was installed on a fresh Arch Cinnamon/X11
desktop, passed all 15 automated preflight gates, tray and Nemo interaction,
English and German UI checks, logout/login lifecycle and package integrity.
The gate exposed and closed a 1280x800 work-area overflow before release. The
exact reviewed package SHA-256 is recorded in the pull request and matching
release notes. Configured Proton-account and transfer review remains required
before Arch is described as generally supported.
34 changes: 19 additions & 15 deletions docs/PORTABILITY.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,11 @@ or mechanically backport commits between them. Distribution differences belong
in small reviewed adapters, package recipes and tests beside the shared source.

Linux Mint 22.x Cinnamon remains the reference and currently supported desktop.
Arch Linux and Ubuntu are the first portability targets. Their presence in an
adapter or container test is not yet a support claim; each target is promoted
only after its complete release gate has passed.
Arch Linux and Ubuntu are the first portability targets. Arch Linux has passed
its clean Cinnamon/X11 installation gate and now has a release-candidate
package for configured real-world review. Adapter or container coverage alone
is never a support claim; each target is promoted only after its complete
release gate has passed.

## Portability envelope

Expand All @@ -30,16 +32,16 @@ credential and UI behavior has been designed and tested.

## Target status

| Distribution | Current status | Promotion work still required |
| --------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Linux Mint 22.x Cinnamon | Reference, supported | Keep the full local and online suite green and retain live Cinnamon/Nemo release testing. |
| Ubuntu 24.04 LTS | Initial target | Complete package layout, clean-system installation, GNOME/keyring/tray testing and release packaging. |
| Arch Linux | Package candidate | Keep smoke and native-package gates green; complete clean-system installation and Fabi's live desktop validation. |
| Debian | Prepared next | Reuse the Debian-family adapter, then validate supported desktop and package versions explicitly. |
| MX Linux | Planned | Decide and test the supported systemd mode; the default non-systemd experience is outside today's lifecycle contract. |
| Fedora | Planned | Add an RPM-family package adapter, spec file and SELinux-aware desktop tests. |
| CentOS Stream / RHEL family | Planned | Establish available GTK, AppIndicator and Python versions before defining a supported release. |
| Univention UCS | Future request | Treat as a separate Debian-derived, server-oriented target; first define the intended desktop and user-session use case. |
| Distribution | Current status | Promotion work still required |
| ---------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Linux Mint 22.x Cinnamon | Reference, supported | Keep the full local and online suite green and retain live Cinnamon/Nemo release testing. |
| Ubuntu 24.04 LTS | Initial target | Complete package layout, clean-system installation, GNOME/keyring/tray testing and release packaging. |
| Arch Linux with Cinnamon/X11 | Release candidate | Keep smoke and native-package gates green; complete configured account, transfer and login-lifecycle review. |
| Debian | Prepared next | Reuse the Debian-family adapter, then validate supported desktop and package versions explicitly. |
| MX Linux | Planned | Decide and test the supported systemd mode; the default non-systemd experience is outside today's lifecycle contract. |
| Fedora | Planned | Add an RPM-family package adapter, spec file and SELinux-aware desktop tests. |
| CentOS Stream / RHEL family | Planned | Establish available GTK, AppIndicator and Python versions before defining a supported release. |
| Univention UCS | Future request | Treat as a separate Debian-derived, server-oriented target; first define the intended desktop and user-session use case. |

## One source tree, small adapters

Expand Down Expand Up @@ -98,8 +100,10 @@ command publishes an image, stable package, tag or release. On pull requests
and explicit workflow dispatches, the same Arch compatibility job reuses its
already pulled image, runs the native package gate and uploads the compressed
package for seven days as `proton-drive-linux-arch-<commit>`. This ephemeral,
commit-bound test candidate exists only for the clean-desktop gate; it is not a
stable distribution package.
commit-bound artifact exists for the clean-desktop gate. A package that passes
that gate may be attached to its matching PDrive GitHub Release for configured
review, but does not become a generally supported distribution package until
the remaining promotion record is complete.

The runner refuses to download an image implicitly. To opt into a current image
download, run:
Expand Down
16 changes: 14 additions & 2 deletions docs/QUICK_START.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,10 @@ upload. Detailed maintenance belongs in [Operations](OPERATIONS.md), not here.
## 1. Install

The supported target is Linux Mint 22.x with Cinnamon, Nemo and a graphical
login. Arch Linux and Ubuntu are active portability targets, not yet supported
release targets; see [Distribution portability](PORTABILITY.md).
login. Arch Linux and Ubuntu are active portability targets. The Arch Linux
`0.8.0-1` candidate has passed its clean Cinnamon/X11 desktop gate and is ready
for configured real-world review, but is not yet a generally supported release
target; see [Distribution portability](PORTABILITY.md).

```bash
git clone https://github.com/oss-singularity/proton-drive-linux.git
Expand All @@ -21,6 +23,16 @@ cd proton-drive-linux
pdrive-ui
```

For the reviewed Arch candidate, download
`proton-drive-linux-0.8.0-1-any.pkg.tar.zst` from the
[`v0.8.0` release](https://github.com/oss-singularity/proton-drive-linux/releases/tag/v0.8.0),
verify its published SHA-256 and replace the source-install commands above with:

```bash
sudo pacman -U ./proton-drive-linux-0.8.0-1-any.pkg.tar.zst
pdrive-ui
```

The installer may request administrator approval once to create the owner-only
`/pdrive` mountpoint. Personal rclone configuration, credentials, cache and
state are preserved when the installer is run again.
Expand Down