Devuan GNU+Linux is a free software operating system for your computer. Free software means you are free to use, copy and distribute, study, change the software, and share your modifications with the community.

If you need to install Devuan from a bootable CD, DVD or USB drive please see this page.

Upgrading to Devuan

This document describes how to upgrade to Devuan Jessie from a Debian Wheezy install or migrate from a Debian Jessie install, incorporating sysvinit and installing the new default desktop environment xfce. At time of writing Devuan Jessie has not yet been announced stable, nonetheless it is in a very usable state and it is possible to upgrade now as if it was simply the next release of Debian.

Please note that I do not recommend upgrades to the testing or unstable branches at this time. If you decide to migrate one of those branches anyway you should know what you’re doing and be prepared to fix any issues that arise.

Supported architectures

At time of writing you can upgrade from the following architectures.

Target branches

All branches are supported for upgrades and migrations from Debian Wheezy and above.

Upgrading to Devuan

First you will need to gain root access at a terminal. Enter your user password when asked.

user@debian:~$ sudo -s

We will now configure the Devuan repository as the source for packages.

root@debian:~# nano /etc/apt/sources.list

Comment out all lines in the sources.list configuration file and add the Devuan repository. I do not recommend using the jessie-backports repo as they are not Devuanized yet. Substitute jessie for ascii or ceres if you want to migrate to those branches instead.

``` #deb wheezy main #deb main #deb wheezy/updates main

deb jessie main deb jessie-updates main deb jessie-security main ```

If you are using any unofficial backports or repositories outside of Debian I suggest removing those packages and their repositories before continuing, unless you know they’re not included in the Devuan branch you are migrating to. This will avoid having extra repositories where you don’t need them and ensure you have up-to-date packages from Devuan. This is outside the scope of this document however as each case for user selected repositories will be different.

In order to fetch packages from the devuan repository for upgrades we need to update the package cache using apt-get, and install the Devuan keyring. We need to allow unauthenticated packages for now or we won’t be able to install the devuan keyring.

root@debian:~# apt-get update && apt-get install devuan-keyring -y --allow-unauthenticated

Now we need to update the package cache once more so that packages will be authenticated from here on in.

root@debian:~# apt-get update -y

It’s time to complete the upgrade.

root@debian:~# apt-get dist-upgrade

Installing the desktop environment

I now recommend that you install xfce - the default desktop environment for Devuan.

root@devuan:~# apt-get install xfce4

Installing the slim display manager is also recommended.

root@devuan:~# apt-get install slim

If there are any remaining systemd components you can safely remove these now. If you are a desktop environment that depends on systemd the display manager may be removed as a result and disrupt your x session, so you should pay attention to the next set of instructions before doing this.

root@devuan:~# apt-get purge systemd-shim libsystemd0

If you installed the slim display manager it will start at boot, but you can start it now after logging in as root at a console.

root@devuan:~# /etc/init.d/slim start


Now that the upgrade is complete and you’ve installed your new desktop I recommend purging any unused packages left over from your previous Debian install.

root@devuan:~# apt-get autoremove --purge

It’s a good time to reclaim some disk space by removing any cached packages that are not installed on the current system.

root@devuan:~# apt-get autoclean

This work is released under the Creative Commons Attribution-ShareAlike 4.0 International [CC BY-SA 4.0] license. Please note that this documentation is provided “AS IS” and comes with absolutely NO warranty. All trademarks are the property of their respective owners.