Convert a FreeBSD System to PC-BSD®/10.1

From PC-BSD Wiki
Jump to: navigation, search


An existing FreeBSD 10.0 installation can be easily converted to either a PC-BSD® desktop or server. This can happen through the installation of a package which is available from the PC-BSD® package repository. The converted desktop will contain all of the graphical utilities that come with PC-BSD®. The converted server will contain all of their command line equivalents.

Switching to the PC-BSD® pkgng Repository

This section demonstrates how to configure a FreeBSD 10.0 system to use the PC-BSD® pkgng repository. Once this configuration is complete, you can then convert that FreeBSD system to either a PC-BSD® desktop or a TrueOS® server as described in the next two sections.

Start by creating this directory:

mkdir -p /usr/local/etc/pkg/repos

Then, create the file /usr/local/etc/pkg/repos/pcbsd.conf with the following contents:

pcbsd: { url: "", signature_type: "fingerprints", fingerprints: "/usr/local/etc/pkg/fingerprints/pcbsd", enabled: true }

Next, create the following directories:

mkdir -p /usr/local/etc/pkg/fingerprints/pcbsd/revoked
mkdir -p /usr/local/etc/pkg/fingerprints/pcbsd/trusted

Then, download the repository's fingerprint file:

fetch --no-verify-peer|txt=
mv /usr/local/etc/pkg/fingerprints/pcbsd/trusted/

Finally, update the package database and any installed packages using the following command:

pkg upgrade -fy                                                                 

Depending upon what is already installed, you may have to resolve some error messages in order to successfully upgrade all packages. To install and delete packages, use the pkg command as described in Section 5.5.3 of the FreeBSD Handbook[1].

Converting FreeBSD to a PC-BSD® Desktop

Once the repository configuration is complete, it is now easy to convert a FreeBSD system into a PC-BSD® desktop using the following commands as the superuser:

fetch --no-verify-peer -o /etc/freebsd-update.conf ''

freebsd-update fetch freebsd-update install pkg install -fy pcbsd-base rehash pbreg set /PC-BSD/SysType PCBSD pc-extractoverlay ports

pc-extractoverlay desktop

Next, reboot the system. The PC-BSD® login manager will start, allowing you to login to the desktop. If you want to set the PC-BSD® display wizard and first boot wizards to run first, run these commands before rebooting:

touch /var/.runxsetup                                                           

touch /var/.pcbsd-firstboot

touch /var/.pcbsd-firstgui
NOTE: If you are using NVIDIA video hardware, load the driver before rebooting into the display wizard by running the command pkg install pcbsd-meta-nvidia.

Converting FreeBSD to a TrueOS® Server

If you wish to convert a FreeBSD server to TrueOS®, install the server package instead, then extract the installed utilities:

pkg install -fy pcbsd-utils                                                     

rehash pbreg set /PC-BSD/SysType TRUEOS pc-extractoverlay ports

pc-extractoverlay server

These steps will install the following: PBI Manager, the command line version of warden, and the command line versions of most of the Control Panel utilities. You will find those utilities in /usr/local/bin/pc-*.


Other languages:German 23% • ‎English 100%