From PC-BSD Wiki
Revision as of 05:52, 13 August 2010 by Drulavigne (Talk | contribs)

Jump to: navigation, search

PC-BSD Guide

Welcome to the PC-BSD FAQS!

The FAQS (Frequently Asked Questions) are meant to answer the questions that users new to PC-BSD ask most. This document is under constant development, meaning that you may come across mistakes and out-of-date information. If you find a mistake or have a question you can't find an answer to, let us know on the Documentation Forum, the Documentation Mailinglist, or by leaving a comment at the PC-BSD Blog. We hope this FAQ is both simple and useful and makes using PC-BSD an enjoyable experience. We value your opinion and thank you for your support.



The FAQS are divided into categories. Each category contains related questions which you can click on to find their answers. You can use your browser's search utility to search for key words to help find the answer you are looking for. Or, you can read through FAQS that sound interesting and learn something new along the way.

If you can't find your answer here, it may be in the [PC-BSD Handbook].

Developer Documentation

Software Installation

How do I install software on my PC-BSD system?

The easiest way is to install PBI software using Software Manager. This is the recommended method as it does everything for you and provides an easy way to find, install, upgrade, and uninstall applications that have been tested to run on your PC-BSD system. It also ensures that you don't inadvertantly overwrite or delete files or libraries needed by the operating system or other applications. Instructions on how to use Software Manager are in this section of the PC-BSD Users Handbook.

Advanced users familiar with the FreeBSD ports and packages collection can use Ports Jail to safely manage their FreeBSD applications. Instructions on how to use Ports Jail can be found in this section of the PC-BSD Users Handbook. NOTE: using ports or packages outside of Ports Jail can over time render your system unusable, especially if a major library changes. Be forewarned and use Ports Jail.

It is not recommended that you download .tgz files directly from sites such as Sourceforge as most software needs to be ported to work on a FreeBSD/PC-BSD system. If the application you are looking for is not in Software Manager or Freshports (which allows you to search for all available FreeBSD ports/packages), it is better to submit a request for a PBI.

Can I use Linux software on my PC-BSD system?

First, you should know that most "Linux" software is really "open source" software. That is, it is freely available for many operating systems, not just Linux. Most software that runs on Linux should also run on PC-BSD.

Like FreeBSD, PC-BSD uses something called Linux Binary Compatability. In a nutshell, that means you can run many Linux applications as-is. This section of the FreeBSD Handbook explains this compatability in more detail and describes when it does not work.

However, you don't have to setup Linux Binary Compatability on your PC-BSD system as it is already configured for you and should "just work". To install applications, see the PC-BSD FAQ How do I install software on my PC-BSD system?.

Using PC-BSD

How do I reset my root password?

Do not panic! Simply restart the system, and select "2. Boot PC-BSD in single user mode" when you see the boot menu. You will see some boot messages which end in this line:

Enter full pathname of shell or RETURN for /bin/sh:

Press enter and you will see a # prompt. Type the following command:

# mount -a -o rw

This will mount all of your filesystems in read/write mode. You can now change the root password with this command:

# passwd
Changing local password for root
New Password:

When you are finished, type exit to continue booting the system.

How do I use a window manager other than KDE?

In order to switch to another desktop environment, you must first log out of KDE using the KDE menu -> Leave -> Logout. When you see the login screen, click the button in the lower left corner (round circle with lines). It will open a menu showing all of the currently installed window managers. By default, Fluxbox and TWM are installed for you. Fluxbox is a light-weight window manager that is easy to use and makes a good choice for older hardware where KDE runs too slowly. TWM is designed for the user who prefers to use the command line and wants an extremely basic windowing system.

Since these window managers are installed with PC-BSD, they provide access to the PC-BSD system tools. This means that you can still use PC-BSD specific utilities such as Software Manager and Update Manager. However, you will quickly discover which utilities came with KDE as these will be missing in the launch menus of other window managers.

If you would like to use GNOME, see the FAQ [ How do I use GNOME on PC-BSD?]. If you would like to install another window manager, see the FAQ [ How do I install another window manager on PC-BSD?].

How do I use GNOME on PC-BSD?

How do I install another window manager on PC-BSD?

Will future versions of PC-BSD pre-install GNOME? and integrate PC-BSD tools into its menus?


How do I enhance fonts in OpenOffice?

Fonts in OpenOffice.org are rather difficult to look nice because OpenOffice.org has its own rendering engine. Basically you can only enable/disable antialiasing at certain fonts sizes instead of taking your system font configuration into account.

You can use Software Manager to install Microsoft fonts, then launch OpenOffice and click: Tools -> Options -> OpenOffice.org -> View. Make sure the boxes "Use system font for user interface" and "Screen font antialiasing" are checked and increase the Pixels to 16. Click the OK button and OpenOffice should look like Microsoft Windows with clear and clean fonts.

This section of the PC-BSD Users Handbook has more information on using True Type fonts.

FreeBSD General Support



Compatible Hardware

Incompatible Hardware


Error Messages

PC-BSD Installation

Preliminary Questions

Post-Installation Issues

PBI Tutorials

Application Problems

Personal tools