TrueOS Tips, Tricks, and FAQ


This is a public FAQ for users to post their most-used tips or frequently asked questions.
Please note that this is not a discussion thread - please create new topics for any discussion.


  1. One tip or FAQ per post please
  2. Put a headline title at the top of your post (### Some Title Here) which summarizes the contents
  3. When possible, try to include both graphical configuration changes and command-line changes to accomplish the same task.

If a tip or trick gets out-of-date, please let a moderator know and we can remove stale tips/questions.

Quick Links for references:

  1. TrueOS Handbook
  2. Lumina Desktop Handbook

System maintenance - quick starter guide
[SOLVED] Errors mounting Linux filesystems
Content for the FAQ Section?


Resyncing System Clock

If your system time gets out of date for some reason (daylight savings, etc), then it can be easily re-synced by restarting the “openntpd” service.

  • [Command Line]
    sudo service openntpd restart

  • [Graphical]
    Control Panel -> System Management -> Services -> Select the “openntpd” service and click the restart button in the lower-left.

Installing KDE onto TrueOS
My watch keeps going for an hour

What is the difference between STABLE and UNSTABLE?

    This is the static release branch of TrueOS and has a 6-month lifetime between updates. It has a higher level of testing and quality-assurance checks to ensure a higher level of reliability for it’s 6-month lifespan.
    IMPORTANT NOTE: This means that applications and utilities will not receive updates to newer versions during the 6-month period.

    This is the rolling-release branch of TrueOS where updates are regularly pushed out every week or two (sometimes multiple times a week - depends on many factors). It will generally have a lower level of manual testing (especially for 3rd-party applications and packages), but ensures that newer versions of FreeBSD and 3rd-party applications are available in a timely manner.

  • Switching between branches

    • [Command Line]
      Edit the “/usr/local/etc/trueos.conf” file and change the “PACKAGE_SET:” option to either “STABLE” or “UNSTABLE”. After that, run pc-updatemanager syncconf to automatically push any changes to your other package config settings, and then run pc-updatemanager pkgupdate to begin downloading/staging the updates. Run pc-updatemanager startupdate to restart the system and perform the updates once the staging procedures are completed.
    • [Graphical]
      Open up the Control Panel -> Update Manager, then go to the “Settings” tab and select the branch that you would like to move to. Click “Save Settings” to apply that change, then go to the “Updates” tab and start the probe/staging of updates. When the updates are staged, follow the prompt to restart the system to apply the updates.


Customizing the List of Favourite Applications and Folders in Lumina’s Main Menu

  • Command Line

    1. Open the ~/.config/lumina-desktop/favorites.list file with your preferred editor.
    2. Add /remove lines according to the existing ones.
    3. Example:
      To add the favourite folder ~/.config to the list, add the line:
    4. Irrespective of the sequence within the favorites.list the main menu is sorted alphabetically.
  • Graphical

    • Removing Items
      Open the Main Menu and right click on the item to remove and choose “Remove from Favorites”.
    • Adding Applications
      Open the Main Menu and Browse Applications. Right click on the application to add and choose “Add to Favorites”.


Where is the Recycle Bin on the Lumina Desktop?

(The entity which allows you to trash a file without deleting it from the system at once.)

  • Lumina doesn’t have and doesn’t need a recycle bin.
    Lumina does not use the “Trash” specifications from (formerly known as the X Desktop Group (XDG)). This is because Lumina was written with the idea that it would be used on systems utilizing the open ZFS* file system and logical volume manager. ZFS snapshots are the “right” way to manage/recover files rather than the “fake” way through the trash specifications.
    (*ZFS formerly known as Zettabyte File System is no longer considered an abbreviation but just a designation.)


How to make text console(Ctrl-Alt-F2) functional on Nvidia cards

Edit your /boot/loader.conf to include:

Note: This will disable the TrueOS logo you see early in the boot process.


How to install VirtualBox

Install the virtualbox-ose from AppCafe.

After this you need to do the following steps, the source will be provided in a link at the end:

Add the following line to /boot/loader.conf:

Add the following line to /etc/rc.conf:

Add yourself to the vboxusers group:
pw groupmod vboxusers -m yourusername

Add these lines to /etc/devfs.conf:
own vboxnetctl root:vboxusers
perm vboxnetctl 0660

Reboot the computer and everything should be good for you to run:

As the link shows, a reboot isn’t required if you do the extra steps. Here is the link(21.6.1):

Virtualbox breaking suspend

Using telegram desktop on TrueOS

TrueOS repositories contain a package that provides the Linux binaries for the Telegram Desktop client. Install it using

pkg install linux-telegram-desktop

Calls do not work. Everything else works.

Potential problems

The following are things I encountered while installing/running telegram-desktop

Issues during linux-c7 installation

This package has linux-c7 as its dependency. If the package installation of linux-c7 fails and complains about being unable to remove existing files in /compat/linux, remove the contents of /compat/linux manually and reboot. Then continue installation.

When you do a manual removal, be careful , since the following are symlinks. Only remove these symlink files, not the directories they point to.

Running telegram-desktop

The command to run Telegram Desktop client is


This may not work or might crash. In some cases it will ask you to login every time you start the app. If you trust the packagers and the telegram desktop code, run it with sudo.

sudo telegram-desktop

If all of this is too bothersome, just wait till TrueOS syncs its ports tree with FreeBSD’s. There is a native build in the ports tree now.

TrueOS - News, How to do ... etc

IPFW Rules for NFS server
Add the following to /etc/ipfw.custom. If you want to allow from “any” replace the IP address with the word “any”, if you want to allow a single IP, replace with yours.
Then either restart the firewall or simply sh /etc/ipfw.custom as root.

# Set rules command prefix
cmd="ipfw -q add"

# Allow NFS from
# NFS needs 2049 for nfsd
# rpcbind at 111
# unfortunately statd/mountd anything below 1024
# Openport rules are added at 10000, default deny at 64000,
# so lets put these at 63000
$cmd 63000 allow tcp from to me dst-port 111-1024 in keep-state :default
$cmd 63001 allow udp from to me dst-port 111-1024 in keep-state :default
$cmd 63002 allow udp from to me dst-port 2049 in keep-state :default
$cmd 63003 allow tcp from to me dst-port 2049 in keep-state :default

TrueOS's ipfw default configuration script

Postgresql 10 server on TrueOS

Install via pkg (as root or sudo )

pkg install postgresql10-server

Running it through FreeBSD init system (rc)

Since there are no open-rc scripts for it, you can run it via the RC script like so.

sudo /usr/local/etc/rc.d/postgresql start

Running postgresql through open-rc

I hacked up an init script. Copy the following code snippet into /usr/local/etc/init.d/postgresql
and make sure it has the same permissions and ownerships as other files in /usr/local/etc/init.d/



# set defaults
postgresql_flags=${postgresql_flags:-"-w -s -m fast"}
eval postgresql_data=${postgresql_data:-"~${postgresql_user}/data10"}
postgresql_initdb_flags=${postgresql_initdb_flags:-"--encoding=utf-8 --lc-collate=C"}
extra_commands="initdb reload"

# Command
command_args="-D ${postgresql_data} ${postgresql_flags}"

    su -l -c ${postgresql_class} ${postgresql_user} -c "exec /usr/local/bin/initdb ${postgresql_initdb_flags} -D ${postgresql_data} -U ${postgresql_user}"

get_config() {
[ -f ${postgresql_data%/}/postgresql.conf ] || return 1
eval echo $(sed -e 's:#.*::' ${postgresql_data%/}/postgresql.conf \
    | awk '$1 == "'$1'" { print ($2 == "=" ? $3 : $2) }')

depend() {
    use net
    provide postgresql

    if [ "$(get_config log_destination)" = "syslog" ]; then
        use logger

checkconfig() {

# Check that postgresql_data directory exists
if [ ! -d ${postgresql_data} ] ; then
    eerror "Directory not found: ${postgresql_data}"
    eerror "HINT: Ensure that postgresql_data points to the right path."
    return 1

# Check for the existence of PostgreSQL's config files, and set the
# proper mode and ownership.
# Only three files should be checked as potentially other files
# may be in PGDATA that should not be touched.
local file
for file in postgresql pg_hba pg_ident ; do
    if [ -f ${file} ] ; then
        checkpath -f -m 0600 -o postgres:postgres ${file}
        eerror "${file} not found"
        return 1


    checkconfig || return 1
    ebegin "Starting Postgresql10"
    rm -f ${postgresql_data%/}/

start() {
    su -l ${postgresql_user} -c "exec ${command} ${command_args} start"

stop() {
    ebegin "Stopping Postgresql10"
    su -l ${postgresql_user} -c "exec ${command} ${command_args} stop"


  su -l ${postgresql_user} -c "exec ${command} ${command_args} status"

reload() {
    ebegin "Reloading Postgres10 config data"
    su -l ${postgresql_user} -c "exec ${command} ${command_args} reload"

Now you can start postgresql service normally

service postgresql start

You can run the following to have it start up with the system by default.

rc-update add postgres

I read rabbitmq’s init file, the postgres rc.d init file and Gentoo’s open-rc file to come up with the script. No unicorns were harmed in its making.


Meltdown, Spectre -FreeBSD first response

Was advised FreeBSD has made their first micro-code update available. Use at your own risk


Installing this port will allow host startup to update the CPU microcode on
a FreeBSD system automatically. In order to enable this feature, add the
following to the system’s /etc/rc.conf:


To ensure the update is applied, reboot the system or start the microcode update
service via:

service microcode_update start

If the CPU requires a microcode update, a console message such as the following
will appear:

Updating CPU Microcode…
/usr/local/share/cpucontrol/m32306c3_00000022.fw: updating cpu /dev/cpuctl0 from rev 0x17 to rev 0x22… done.
/usr/local/share/cpucontrol/m32306c3_00000022.fw: updating cpu /dev/cpuctl2 from rev 0x17 to rev 0x22… done.
/usr/local/share/cpucontrol/m32306c3_00000022.fw: updating cpu /dev/cpuctl4 from rev 0x17 to rev 0x22… done.
/usr/local/share/cpucontrol/m32306c3_00000022.fw: updating cpu /dev/cpuctl6 from rev 0x17 to rev 0x22… done.

Master Sites:

There is no master site for this port.


Open-RC scripting and how to write


Settings in /etc/periodic.conf

I like to override some of the defaults for the periodic scripts. Don’t email to root, keep output in a file. Don’t do DNS lookups, clean /tmp, add ZFS, NTP and SMART status in the daily log. Here’s how I do it:

# periodic.conf overrides
# output to file
daily_scrub_zfs_enable="NO"    # set to YES for autoscrubbing at threshold days
daily_scrub_zfs_default_threshold="45"          # days between scrubs
daily_status_smart_devices="/dev/ada0 /dev/ada1 /dev/ada2"


Cleaning Linux partitions in TrueOS and w/o Linux distro


ZFS and how to access missing pools:


USB-Audio as default audio device (HOWTO):

A) Read man-page: 

% man snd | grep -A 17 hw.snd.verbose
             Level of verbosity for the /dev/sndstat device.  Higher values include
             more output and the highest level, four, should be used when reporting
             problems.  Other options include:

             0   Installed devices and their allocated bus resources.

             1   The number of playback, record, virtual channels, and flags per

             2   Channel information per device including the channel's current
                 format, speed, and pseudo device statistics such as buffer
                 overruns and buffer underruns.

             3   File names and versions of the currently loaded sound modules.

             4   Various messages intended for debugging.

B) Set settings accordingly:

% cat /boot/loader.conf.local | grep snd

C) Reboot

D) Check /dev/sndstat:

% cat /dev/sndstat  | grep snd_uaudio
pcm4: <USB audio> at ? kld snd_uaudio (1p:1v/1r:1v) default

E) Set settings accordingly:

% cat /boot/loader.conf.local | grep 'snd.default_unit'

F) Reboot

That’s all.


A rough overview of using Nvidia Optimus on FreeBSD.


Once you change to using the IPFS network

You will need to sync your system as well, run the following commands;

sudo pc-updatemanager confcheck
sudo pc-updatemanager syncconf
sudo pc-updatemanager pkgcheck

Cannot upgrade to 18.03

iPhone Hotspot USB tethering to TrueOS Laptop

Look at this link --> iPhone Hotspot USB tethering to TrueOS Laptop