====== Migrate to Devuan Ascii ======

This document describes how to migrate to Devuan Ascii from Debian Jessie or Stretch.

===== Migrating from the GNOME desktop =====

Because there is no transitional package yet GNOME users will need to install xfce4 and slim manually. Choose slim as the default display manager when prompted.

<code>root@debian:~# apt-get install xfce4 slim</code>

Set the session manager to startxfce4 so that the new desktop can be used later.

<code>root@debian:~# update-alternatives --config x-session-manager</code>

===== Replacing network manager with wicd =====

If you are relying on network manager for network access you need to change to wicd now. Another option is [[manual network configuration]].

<code>root@debian:~# apt-get install wicd</code>

Make sure network manager is removed from the boot process.

<code>root@debian:~# update-rc.d -f network-manager remove</code>

Wireless connections should now be configured to automatically connect with wicd. Stop network manager before configuring your network.

<code>root@debian:~# /etc/init.d/network-manager stop</code>

===== Perform the migration =====

Devuan uses sysvinit by default so we will install this now.

<code>root@debian:~# apt-get install sysvinit-core</code>

A reboot is required to switch sysvinit to pid1 so we can remove systemd.

<code>root@debian:~# reboot</code>

We can now remove systemd without any complaints.

<code>root@debian:~# apt-get purge systemd</code>

Edit the sources.list file so that we can switch to the Devuan repositories.

<code>root@debian:~# editor /etc/apt/sources.list</code>

Add the Devuan mirrors with the Ascii branch name. Comment out any other lines.

<code>
deb http://pkgmaster.devuan.org/merged ascii main
deb http://pkgmaster.devuan.org/merged ascii-updates main
deb http://pkgmaster.devuan.org/merged ascii-security main
deb http://pkgmaster.devuan.org/merged ascii-backports main
</code>

Update the package indexes so we can install the Devuan archive keyring.

<code>root@debian:~# apt-get update</code>

Install the Devuan keyring so packages can be authenticated from this point onwards.

<code>root@debian:~# apt-get install devuan-keyring --allow-unauthenticated</code>

Update the package indexes again so that they are authenticated with the keyring.

<code>root@debian:~# apt-get update</code>

Finally we can migrate to Devuan.

<code>root@debian:~# apt-get dist-upgrade</code>

===== Post migration tasks =====

systemd components should now be removed from the system.

<code>root@devuan:~# apt-get purge systemd-shim</code>

If you are not using D-Bus or xorg you might be able to remove libsystemd0.

<code>root@devuan:~# apt-get purge libsystemd0</code>

Purge any orphaned packages left over from your previous Debian install.

<code>root@devuan:~# apt-get autoremove --purge</code>

This is a good time to clean out old package archives left over from your Debian system.

<code>root@devuan:~# apt-get autoclean</code>

This work is released under the Creative Commons Attribution-ShareAlike 4.0 International [[https://creativecommons.org/licenses/by-sa/4.0/|CC BY-SA 4.0]] license. All trademarks are the property of their respective owners. This work is provided "AS IS" and comes with absolutely NO warranty.