A new UNSTABLE update for TrueOS is available!

Released regularly, UNSTABLE updates are the full “rolling release” of TrueOS. UNSTABLE includes experimental features, bugfixes, and other CURRENT FreeBSD work. It is meant to be used by those users interested in using the latest TrueOS and FreeBSD developments to help test and improve these projects.

WARNING: UNSTABLE updates are released primarily for TrueOS and FreeBSD testing/experimentation purposes. Update and run UNSTABLE “at your own risk”.


Current TrueOS users can update using the built-in update manager. Additionally, UNSTABLE installation files are available on the TrueOS website.


Note: There was a CDN issue over the weekend that caused issues for early updaters. Everything appears to be resolved and the update is fully available again. If you encountered instability or package issues from updating on 8/6 or 8/5, roll back to a previous boot environment and run the update again.




  • UNSTABLE .iso and .img files beginning with TrueOS-2017-08-3-x64 will be available to download from http://download.trueos.org/unstable/amd64/. Due to CDN issues, these are not quite available, look for them later today or tomorrow (8/8/17).



  • Experimental patch for libhyve-remote: (From https://github.com/trueos/freebsd/commit/a67a73e49538448629ea27, thanks araujobsd)
    • The libhyve-remote aims to abstract functionalities from other third party libraries like libvncserver, freerdp, and spice to be used in hypervisor implementation. With a basic data structure it is easy to implement any remote desktop protocol without digging into the protocol specification or third part libraries – check some of our examples.We don’t statically link any third party library, instead we use a dynamic linker and load only the functionality necessary to launch the service.Our target is to abstract functionalities from libvncserver, freerdp and spice. Right now, libhyve-remote only supports libvncserver. It is possible to launch a VNC server with different screen resolution as well as with authentication.With this patch we implement support for bhyve to use libhyve-remote that basically abstract some functionalities from libvncserver.
    • We can:
      Enable wait state.
      Enable authentication.
      Enable different resolutions.
      Have a better compression.
    • Also, we add a new -s flag for vncserver, if the libhyve-remote library is not present in the system, we fallback to bhyve RFB implementation. For example:
      -s 2,fbuf,tcp=,w=800,h=600,password=1234567,vncserver,wait


  • New SysAdm Client pages under the System Management category:
    • System Control: This is an interface to browse all the sysctl’s on the system.

    • Devices: This lists all known information about devices on the designated system.


  • Lumina Theming: Lumina is testing new theming functionality! By default (in UNSTABLE), a heavily customized version of the Qt5ct engine is included and enabled. This is intended to allow users to quickly adjust themes/icon packs without needing to log out and back in. This also fixes a bug in Insight with different icons loading for the side and primary windows. Look for more information about this new functionality to be discussed on the Lumina Website.


  • Update to Iridium Web Browser: Iridium is a Chromium based browser built with user privacy and security as the primary concern, but still maintaining the speed and usability of Chromium. It is now up to date – give it a try and let us know what you think (search for iridium-browser in AppCafe).


  • Early addition of new translation files for Australian.


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 in downloading and installing TrueOS. It also walks the reader through a basic post-install configuration and has application recommendations for a few common tasks such as 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 fine tune the desktop experience.

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

  • Appcafe: Install and manage applications.
  • Update Manager: Updating TrueOS and any installed applications.
  • Boot Environment Manager: Easily switch between saved ZFS boot environments (typically for system troubleshooting.
  • Firewall Manager: Adjust your networking firewall.
  • Service Manager: View and configure all installed services.
  • Task Manager: View system resource consumption and manage running programs.
  • User Manager: Manage system users and groups, including adding encryption to users.
  • Life Preserver: Manage system backups using the features of ZFS <LINK>.

These handbooks are designed to help users initialize and configure TrueOS to meet their specific desktop needs.


Community Help


If you encounter difficulty while using or configuring TrueOS, there is a knowledgeable and friendly community of users who are happy to help you 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.
  • 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, report it via one of our GitHub issue trackers. Here are the various TrueOS project bug trackers:

The TrueOS handbook has detailed instructions to help 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!