A new STABLE update for TrueOS is available! Released on a six month schedule, STABLE updates represent a significant step forward for TrueOS (see our earlier post discussing this change). There is more extensive testing of new features and less experimental work in STABLE images, resulting in a more solid and usable experience.

Current TrueOS users can update using the built-in update manager. This STABLE update also has .iso and .img files available for download from the TrueOS website. These new files are TrueOS-2017-06-01-x64-DVD.iso, TrueOS-2017-06-01-x64-USB.img, and their related checksum files. The .iso works for DVD or VM installs, while the .img file is only for USB installations (see the TrueOS handbook’s Burning the Installation Media section).





  • Add branching to TrueOS project repositories: STABLE releases now have their own branches.
  • Fix VIM issue with AMD
  • The installer only loads the VESA (for MBR) and SCFB (for UEFI) graphics drivers initially to ensure maximum system compatibility.
  • HAL is unset and not installed by default. While not recommended for use, HAL is still available in the package repository.
  • Unset PGSQL to prevent conflicts with mysql and sqlite.
  • Unset CONSOLEKIT by default.
  • Cleaned up old virtualbox startup routine.
  • Improve installer functionality in 640×480.
  • Installer text has been reworked slightly.
  • First boot wizard is reworked a little.
  • The installer is updated with a new Optional Installation Packages screen. Users can choose an optional graphics driver from the included list. This allows you to choose from all versions of the available nVidia and virtual environment “guest” drivers.
  • OpenRC is updated to 0.26.2.
  • Make sure pc-checkxdisplay runs the xorg setup on firstboot.
  • Bugfix for the Network Manager: wireless signal strength should be detected better.
  • Added cut/copy/rename functionality to desktop icons with Lumina. The desktop also has paste/new file/new folder functionality added.
  • The TrueOS handbook has undergone numerous updates to remove/replace outdated text and screenshots.
  • Lumina is updated to version 1.2.2.
  • The Lumina port is now modular: the x11/lumina metapackage still installs all Lumina utilities (same functionality as is currently available). However, Lumina is now also broken down into a few standalone packages. Individual desktop utilities can be found under deskutils/lumina-*, the Lumina Desktop now exists in the x11/lumina-core package, and the core utilities are in x11/lumina-coreutils.


FreeBSD Ports Update:


  • Fix building py-libzfs on HEAD/TrueOS which has the compressed ZFS send/recv now.
  • Fix py3-iocage depends.
  • Remove legacy py-iocage from ports tree build.
  • devel/py-libzfs: update to 1.0.20170525.
  • Mark pyp3 as broken.
  • Ensure iocage runs with UTF-8.
  • Fix the depends for py3-iocage.
  • Update wine-mono run depend.
  • Update texinfo.tex from 2017-04-14.11 to 2017-05-14.14.
  • Update py3-iocage to
  • Fix an issue with returning zfs mount properties that need to be UTF-8.
  • Use supervise-daemon for dbus.
  • bsdstats no longer shows as “crashed”, it is meant to run a single time.
  • Switch cupsd to use supervise-daemon.
  • Numerous FreeBSD port updates. The full list of commits is in the trueos/freebsd-ports STABLE branch.
  • OpenRC Conversions:
    • www/mongoose
    • www/shellinabox
    • www/fabio
    • www/thttpd
    • www/pglogd
    • www/tomcat-devel
    • www/red5
    • www/trafficserver
    • www/py-graphite-api
    • www/monast
    • www/httptunnel
    • sysutils/rubygem-chef
    • www/bigbluebutton
    • www/cherokee
    • www/cntlm
    • www/helma
    • www/interchange
    • www/jetty9
    • www/junkbuster
    • www/lighttpd
    • www/seahub
    • www/sogo2
    • www/tomcat8
    • www/trac
    • www/tt-rss
    • www/uwsgi
    • www/varnish5
    • www/vdradmin-am
    • www/nostromo
    • www/nghttp2
    • www/mohawk
    • www/domoticz
    • www/zope213
    • www/spawn-fcgi
    • www/webfs
    • www/tomcat6
    • www/twms
    • www/dhttpd
    • www/radicale
    • www/havp
    • www/grafana3
    • www/xshttpd-devel
    • www/bozohttpd
    • www/tclhttpd
    • www/spreadlogd
    • www/kannel-qlbox
    • www/zerowait-httpd
    • www/h2o
    • www/madsonic-standalone
    • www/polipo
    • www/butterfly
    • www/grafana4
    • www/transproxy
    • www/gitea
    • sysutils/immortal
    • www/resin3
    • www/anyterm
    • x11/kde4-workspace
    • x11-drivers/xf86-input-wacom
    • x11-fonts/xfs
    • x11-servers/Xfstt
    • www/tinyproxy
    • www/aria2
    • www/redmine
    • www/nxinx-devel
    • www/nginx
    • sysutils/linux-crashplan
    • www/apache22
    • www/apache24
    • x11/lightdm
    • x11/slim


Known Issues


  • There may be an issue with selecting Modesetting on new installs from the display wizard.
  • We are seeing some instability when using the network manager to restart the network.


Additional Resources




As “TrueOS” incorporates the Lumina Desktop Environment and SysAdm, new users are encouraged to reference all three projects’ documentation.

The TrueOS handbook contains a comprehensive guide to assist you in downloading and installing TrueOS. It also walks you through a basic post-install configuration and has application recommendations for tasks like printing and multimedia playback.

The Lumina handbook contains numerous instructions for customizing every aspect of the desktop environment. Instructions for customizing desktop appearance, default applications, menu contents, and general system settings are all contained in this handbook. Additionally, full descriptions of each included Lumina Utility and plugin are available, to further help you fine tune your desktop experience.

The SysAdm Client handbook describes and guides you through using system management utilities via the SysAdm client. Here is a short list of system utilities discussed in this handbook:

These handbooks are designed to help you initialize and configure TrueOS to meet your specific desktop needs.


Community Help


If you encounter difficulty while using or configuring TrueOS, there is a knowledgeable and friendly community of users happy to help troubleshoot TrueOS. Many of the developers and contributors to the TrueOS, Lumina, and SysAdm projects can also be found answering questions or discussing Open Source development in these channels. Here is a general breakdown of our community channels:

  • Discourse: The primary TrueOS forum. Discourse is used for lengthy discussions on particular topics, as well as a good place to ask questions or get assistance troubleshooting TrueOS. You don’t need an account to view posts on Discourse, but posting does require logging in with either a Discourse, Facebook, or GitHub account.
  • Gitter: Gitter provides real-time collaboration with TrueOS users and developers. Gitter does not require an application to use, but a GitHub or Twitter account is required to log in and post.
  • IRC: Like many open source projects, TrueOS has an Internet Relay Chat (IRC) channel so users can chat and get help in real time. To get connected, use this information in your IRC client:
    • Server name: irc.freenode.net
    • Channel name: #trueos (note the “#” is required)
  • TrueOS Subreddit: The TrueOS Project also has a Subreddit for users who prefer to use Reddit to ask questions and to search for or post how-tos. A Reddit account is not required in order to read the Subreddit, but it is necessary to create a login account to submit or comment on posts.


Bug Reporting


If you discover a bug while using TrueOS, you can report it via one of our GitHub issue trackers. Here is the breakdown for which tracker to use for your bug:

  • trueos-core: Used for general TrueOS issues, Pico issues, and feature requests.
  • lumina: Lumina Desktop Environment bugs.
  • (Coming Soon) sysadm: SysAdm client or server bugs.
  • trueos-docs: TrueOS handbook issues.
  • lumina-docs: Lumina handbook issues.
  • sysadm-docs: Tracker for SysAdm API Guide, Client, and Server handbooks.
  • trueos-website: Issues involving any of the TrueOS Project websites:
    • https://www.lumina-desktop.org
    • https://www.trueos.org
    • https://www.sysadm.us

The TrueOS handbook has detailed instructions to help you report a bug. It is recommended to refer to these instructions when creating new GitHub issues. Better bug reports usually result in faster fixes!

To request a new feature, open a new issue in one of the related GitHub issue repositories and begin the title with “Feature Request”:.

Thanks for using TrueOS!