Kupfer Linux

Archlinux for mobile devices
the best pmOS clone you've ever seen
my phone runs Arch btw
go > rust

Author: Prawn
Date: 2022-11-09 03:20:00

v0.1.5, Preparing for v0.2.0rc0

Hi there!

I've tagged v0.1.5 with the changes that happened since the last release and pushed it to the main branch.

I'll soon merge my oversized Kupferbootstrap and PKGBUILDs merge requests into dev; somewhere between the evenings (CET) of Thursday (2022-11-10) and Friday (2022-11-11).

As they will form the basis for v0.2.0, I will be calling them v0.2.0rc0.

I'm announcing this early to give people some time to migrate to main before blindly updating themselves into half a dev installation.

We'll both show you how to migrate to main in order to stay on v0.1.5 and give you a preview of what's new in v0.2.0rc0, right after the usual release notes for v0.1.5.

Kupfer v0.1.5#

Kernel 6.0, phosh was rebuilt since gnome got updated to 43, phosh-mobile-configs got packaged by Syboxez!


kupferbootstrap v0.1.5

Literally no changes.


pkgbuilds v0.1.5

Thanks to Syboxez for packaging phosh-mobile-settings and updating the kernels!

Migration Instructions#

So, without further ado, let me present you with your two options:

  1. Don't want to be the victim of my development whims so much? Want to postpone the migration pain until v0.2.0 is ready and fully released? Prefer smooth-ish sailing? Understandable.
    You can stay on v0.1.x for now by switching to the main branch (if you're unsure, read the linked instructions on how to change branches - you'll see what you have). You can already do this today, before v0.2.0rc0 hits dev!
  2. Or: Take a ride, experience and test the new Kupfer(bootstrap) with us. Unlike previous versions, updating will require some manual interventions.
    If you're up for it, wait for the release blog post with the migration instructions for v0.2rc0 in the next two days.
    Sidenote: After v0.2.0 (proper) is released to main, you will have to do this anyway, but more things might change along the way; dev is short for development after all.

Migrating to the main branch#

Updating to v0.1.5 is as easy as switching to the newest version of the main branch in both kupferbootstrap.git and pkgbuilds.git.

Step by step:

  1. Open a terminal.
  2. Edit your config file:
    1. Open your config file with your favourite editor, e.g. nano ~/.config/kupfer/kupferbootstrap.toml.
      If that file doesn't exist or is empty for some reason, run kupferbootstrap config init -N now and reopen the file.
      It should contain the default values now.
    2. In the [pkgbuilds] section, set git_branch to "main"
    3. in the [pacman] section, set repo_branch to "main"
      git_branch = "main"
      repo_branch = "main"
  3. Change directory (cd) into your kupferbootstrap directory, then run the following commands:
    git remote update
    git switch -f main
    git reset --hard origin/main
  4. Make sure all the python dependencies from requirements.txt are installed. Either consult the AUR or [create a venv and] run pip install -r requirements.txt
  5. Change directory into your pkgbuilds directory (~/.cache/kupfer/pkgbuilds by default) and run the commands from the last step here too.
  6. If all of that succeeded, back up and regenerate your config, just in case: cp ~/.config/kupfer/kupferbootstrap.toml{,.premigration} && kupferbootstrap config init -N

Migrating your existing phone installation to main#

On your device, edit your pacman.conf, e.g. sudo nano /etc/pacman.conf, best done from a PC with SSH.

  1. Ensure your Kupfer repos towards the end of the file are pointing at /main/, not /dev/, like so:

    Server = https://gitlab.com/kupfer/packages/prebuilts/-/raw/main/$arch/$repo

    Change this for all the Kupfer repos.

  2. After making it so, upgrade your system with pacman -Syu. You should be done.

What's new in v0.2rc0#

Here's the major changes you can look forward to, off the top of my head: