**This guide replaces the previous migration guide, and is fully up to date. dev1fanboy.**

====== Migrate to Devuan Jessie ======

This document describes how to migrate to Devuan Jessie from Debian.

===== Performing the migration =====

We need to edit the mirrors list so we can set the Devuan repository as the source for packages.

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

Change your mirrors to the Devuan mirror, commenting out the previous Debian mirrors.

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

Before we can fetch packages from the Devuan repository we need to update the package index files.

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

The Devuan keyring is required to authenticate packages.

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

Now that the Devuan keyring is installed you should update the indexes again so that packages are authenticated from now on.

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

We can now migrate to Devuan. Choose slim as the default display manager if prompted.

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

In order to remove systemd as pid1 a one time reboot is required.

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

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

If you were using GNOME under Debian before migration I recommend changing the session manager to startxfce4.

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

systemd components should now be removed from the system.

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

If you are not using D-Bus 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.