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.

This is the first “true” UNSTABLE update since the 6-month STABLE image was released (June 2,2017). Previous UNSTABLE updates from June and July were maintaining parity between the two tracks. Now, UNSTABLE is ready to break away from STABLE and fulfill the developer goal to have an experimental, rolling-release, but still full-featured version of TrueOS.


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

Current TrueOS users can update using the built-in update manager. Users already on UNSTABLE need to run pc-updatemanager syncconf in a command line to properly switch over to the new UNSTABLE repository URL. An alternate method is to switch from UNSTABLE to STABLE and click “Save” in the update manager, then switch back to UNSTABLE and click “Save” again. This resyncs the configuration files for the new repositories.

New UNSTABLE .iso and .img files beginning with TrueOS-2017-07-14-x64 are also available to download from http://download.trueos.org/unstable/amd64/ ! As of now, UNSTABLE and STABLE TrueOS .iso/.img files have the same naming. This is going to change very soon, but for the moment, users are cautioned to keep their UNSTABLE downloaded .iso files separate from the STABLE equivalent.




  • The UNSTABLE update repository has a new URL.
  • TrueOS UNSTABLE is synced with FreeBSD CURRENT as of June 22.
  • The TrueOS UNSTABLE branch of FreeBSD-ports is synced with FreeBSD as of July 11.
  • New UNSTABLE .iso and .img files beginning with TrueOS-2017-07-14-x64 are available to download and test.
  • Modules now load before running the sysctl init.d script.
  • trueos-server and trueos-desktop now select the proper package repository at load (installer fix).
  • HBSD: net/haproxy: Update LibreSSL patch
  • Added OpenRC script for OpenVPN
  • Add many more OpenRC service files:
    • dnscrypt-wrapper
    • dnscrypt-proxy
    • Courier
    • beanstalkd
    • ceph
    • dhcpd
    • foreman_proxy
    • glusterd
    • linknx
    • mosquitto
    • ntpa
    • ovsdb_server
    • repeater
    • rtgpoll
    • srelay
    • stone
    • Fixes to gdm
    • cx88d
    • emby_server
    • ffserver
    • freevo
    • zoneminder
  • Update to pc-updatemanager port
  • Fix config.sh location
  • Add XCB to ffmpeg options
  • FreeBSD ino64 patch is implemented for testing.


Known issues


  • VirtualBox is completely broken in this latest UNSTABLE version. Investigation is ongoing, but it initially appears to be a FreeBSD regression in CURRENT.



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!