news

v18.0 Stable Release #6 - 10 Newly Updated ISOs, Hub Builds & Proxmox/LXC builds

Mattalynn Darden — Wed, 17 Apr 2024 01:41:20 +0000

The TKL team is thrilled to unveil 10 fresh updates to our appliance lineup!

See here for all v18.x announcements. These 10 updated apps are available now on the TurnKey Hub, as well as downloads as ISOs or Proxmox/LXC builds.

We're excited to announce that the release of 10 appliances is finally here, after a bit of a wait! Apologies for the delay—the TKL team is focused on streamlining our processes to make our company more efficient and give you guys faster releases.

While there are only a few appliances left to update (some have been retired), please note that the next batch might take a bit longer. We've saved the most challenging ones for last, but we're making progress!

Key Points from this Batch's Updates

These appliances from this batch have numerous bug fixes and enhancements. If any appliance in this batch or previous ones lacks certain updates, you can typically install them via apt. Just keep in mind that one update, the PHP version change/update script in all PHP-included appliances, can't be installed this way. Here's the lineup, listed in no particular order:

Downgraded Bugzilla to 5.0.6 due to tracker issues in #1918
Gitea as of v1.19 includes CI/CD [closes #1877] & fixed Gitea appliance inithook (note correct username 'gitea', not 'admin') [closes #1808]
Installed latest GitLab-CE v16.7.7 - from third party GitLab apt repo.
Upgraded to latest LTS version of TYPO3 12.x via composer: 12.4.12
Updated Mattermost to latest upstream: v9.0.1.
Installed latest Observium CE release - 23.09.13005
Installed latest upstream version of phpBB: 3.3.11
Install latest version of processwire: 3.0.227
Updated roundup to 2.3.0
Updated to latest upstream Syncthing (via upstream apt repo) - v1.27.4

Exciting news! Some appliances now come with fixed upstream bugs and added features from third-party providers. This release automatically includes these updates (all upstream software updated since v17.x), bringing even more value to our users.

This Release's Updated v18.0 Apps

Here are the updated apps in this batch:

Bugzilla	Gitea	Gitlab	Mattermost
Observium	Phpbb	Processwire	Roundup
Syncthing	Typo3

All v18.0 apps to date

Per usual, here's all the appliances that have been updated to v18.0 so far:

Avideo	Bagisto	Bookstack	Bugzilla
Cakephp	Codeigniter	Concrete-cms	Core
Couchdb	Django	Dokuwiki	Drupal10
Drupal7	E107	Elgg	Espocrm
Etherpad	Foswiki	Gitea	Gitlab
Icescrum	Invoice-ninja	Joomla4	Lamp
Lapp	Laravel	Leantime	Lighttpd-php-fastcgi
Limesurvey	Mantis	Matomo	Mattermost
Mediawiki	Mibew	Mysql	Nextcloud
Nginx-php-fastcgi	Nodejs	Observium	Omeka
Opencart	Openldap	Openvpn	Orangehrm
Oscommerce	Otrs	Owncloud	Phpbb
Phplist	Postgresql	Prestashop	Processwire
Redmine	Roundup	Silverstripe	Simplemachines
Suitecrm	Syncthing	Tkldev	Typo3
Web2py	Wireguard	Wordpress	Zencart

Give them a try and share your feedback

Any problems with any v18.0 appliances, any of our custom software or other included tools, please feel free to post in our support forums or lodge an issue on our GitHub Issue Tracker.

Both GitHub and our Forums require registered user accounts. GitHub accounts are easy to create and should "just work" (because they have lots of resources and thus advanced spam managment). Unfortunately due to large amounts of spam, the automated website account approval requires manual approval. If you don't have an account and want one, please register for one. Then follow the instructions in the automated account creation email that should be sent out immediately. An alternate option if you have feedback is to do a guest comment here, using the email that you registered with and note that you also want your website account enabled. If you don't want a website account but do have feedback, please just do a guest comment here.

Please note that any guest posts will require manual moderation. so your post won't be visiable until it's approved. So if you can't see your post, that's likely why.

Looking Ahead

This release is a part of our ongoing effort to deliver robust, secure, and flexible server appliances. We're already working on the next batch of updated appliances, but as noted above, the next batch may not be that quick. As always we're guided by your feedback and the evolving needs of all our user base, please do provide feedback - good or bad. Regardless, stay tuned for more updates, and as always, we value your input and support.

Thank you for choosing TurnKey Linux. Happy deployments!

Blog Tags:

v18.0 Stable Release #5 - 20 Updated ISOs & Hub Builds - Proxmox/LXC builds

Jeremy Davis — Mon, 12 Feb 2024 05:47:43 +0000

Finally, following the announcement last week, we're back again with another batch of updated appliances - 20 to announce this time! See here for all v18.x announcements. These 20 updated apps are available now on the TurnKey Hub, as well as downloads as ISOs or Proxmox/LXC builds.

The announcement of 10 of these appliances is well overdue. Half of these have been live and downloadable for some time. The issue is that I have been quite distracted working on other things and while I had drafted the blog announcement for those, I never quite completed and published it.

While there are not that many left to update (a number have been deprecated), it's worth being aware that the next batch will probably be a little while away. That is because we've left the trickiest ones until last.

v18.0 Update batch details

There are a number of bugfixes and improvements in many of these appliances, although the first 10 might not have them all out of the box. For any (in this batch or previously) that don't already include all these updates, most of them should be installable via apt, although at least one (the PHP version change/update script in all appliances that include PHP) isn't. Here they are (in no particular order):

Ensure hashfile includes URL to public key - closes #1864.
Include/install webmin-logviewer module by default - closes #1866.
Upgraded webmin to v2.105.
Set mod_evasive log location - makes debugging easier.
TKLBAM: fix fixclock hook bug - closes #1910.
TKLBAM: MySQL restore from v16.x and earlier failing - closes #1872.
TKLBAM - PostgreSQL restore failing - closes #1867
Make using an alternate PHP version easier, via tkl-upgrade-php script - closes #1892.
As noted in last release: Confconsole - bugfix for LE DNS-01 certificates - closes #1876 & #1895.

Note that some appliances have had upstream (i.e. software provided by third parties) bugs fixed and/or features added. This release includes those by default (all upstream software is updated where available since v17.x).

v18.0 Apps updated this release

Here are the updated apps in this batch:

AVideo	CakePHP	CouchDB	Django
Elgg	EtherPad	Foswiki	iceScrum
InvoiceNinja	Leantime	LighHTTPd PHP FastCGI	LimeSurvey
Mediawiki	OpenCart	OpenVPN	((OTRS))CommunityEdition
Redmine	SimpleMachines	Web2py	Wireguard
Zencart

All v18.0 apps to date

Please find all the appliances (in alphabetical order) that have been released for v18.0 so far listed below:

AVideo	Bagisto	BookStack	CakePHP
CodeIgniter	ConcreteCMS	Core	CouchDB
Django	DokuWiki	Drupal10	Drupal7
e107	Elgg	EspoCRM	EtherPad
Foswiki	iceScrum	InvoiceNinja	Joomla4
LAMPStack	LAPPStack	Laravel	Leantime
LighHTTPd PHP FastCGI	LimeSurvey	Mantis	Matomo
Mediawiki	Mibew	MySQL	Nextcloud
NGINXPHPFastCGIServer	Nodejs	Omeka	OpenCart
OpenLDAP	OrangeHRM	osCommerce	((OTRS))CommunityEdition
OpenVPN	ownCloud	phpList	PostgreSQL
Prestashop	Redmine	SimpleMachines	SilverStripe
SuiteCRM	TKLDev	Web2py	Wireguard
WordPress	Zencart

Give them a try and share your feedback

Any problems with any v18.0 appliances, any of our custom software or other included tools, please feel free to post in our support forums or lodge an issue on our GitHub Issue Tracker.

Please note that any guest posts will require manual moderation. so your post won't be visiable until it's approved. So if you can't see your post, that's likely why.

Looking Ahead

Thank you for choosing TurnKey Linux. Happy deployments!

Blog Tags:

v18.0 Stable Release #4 - 10 Updated ISOs & Hub Builds - Proxmox/LXC builds

Jeremy Davis — Mon, 05 Feb 2024 09:23:12 +0000

We're thrilled to announce the forth stable release of version 18.0, bringing another 10 updated appliances, including updated ISOs and Hub builds, with Proxmox/LXC support builds as well! This release marks another milestone in our commitment to providing versatile and reliable solutions for our users - albeit a little delayed. FWIW, these have actually been published for a little while, I've just been a bit slow finalising this announcement. Regardless, whether you're running a personal project or managing enterprise-level deployments, this update brings more of our library up to date.

As per usual, these updated appliances can all be found on our mirror network, downloaded from their relevant appliance pages (links below) or they can be launched directly from the Hub (note that 17.x appliances are still the default for now - please see the first announcement for launching v18.0 apps).

v18.0 Update batch details

As probably expected, this release includes the bug fixes from the previous release batch.

Unfortunately, it's also been discovered that all v18.0 appliances released to date (including this batch 🙁) include a buggy Confconsole DNS-01 Let's Encrypt plugin. This plugin is designed to leverage your DNS provider to provide the requisite DNS info to validate that you control the domain. This is a very useful method if your server is not publicly available, but you want "proper" CA signed certificates for your server and avoids those pesky browser warnings. It also the only way to get a wildcard certificate (e.g. *.example.com) - which will match any/all subdomains (of the same level; e.g. *.example.com will work for a.example.com, b.example.com, etc; but not a.b.example.com). Please note that whilst your server can be locally hosted and not available to the public, but it must have outgoing internet - to connect to your DNS provider's API.

The initial release in v18.0 has some issues. However, a new updated and fully functional version has been built and published. This new version can be easily installed by updating it via apt. The version you want is v2.1.4. If you are running a v18.0 TurnKey server, be sure you have that version. To check:

apt policy confconsole

E.g. with the buggy v2.1.2 installed, you should see this:

confconsole:
  Installed: 2.1.2
  Candidate: 2.1.4
  Version table:
     2.1.4 999
        999 http://archive.turnkeylinux.org/debian bookworm/main amd64 Packages
 *** 2.1.2 100
        100 /var/lib/dpkg/status

Simply upgrade with apt. E.g.:

apt update
apt install confconsole -y

Then run Confconsole:

confconsole

Finally select Advanced >> Let's Encrypt >> Get certificate >> DNS-01 and follow the prompts. It may take a few minutes initially, but should set everything up for you.

Many (many) DNS providers are supported, but each one will have slightly different configuration requirements. Please check the details for your specific provider by clicking the relevant link on this page.

v18.0 Apps updated this release

Here are the updated apps in this batch:

CodeIgniter	e107	EspoCRM	Laravel
Mantis	Matomo	Mibew	OpenLDAP
phpList	PostgreSQL

All v18.0 apps to date

Please find all the appliances (in alphabetical order) that have been released for v18.0 so far listed below:

Bagisto	BookStack	CodeIgniter	ConcreteCMS
Core	DokuWiki	Drupal10	Drupal7
e107	EspoCRM	Joomla4	LAMPStack
LAPPStack	Laravel	Mantis	Matomo
Mibew	MySQL	Nextcloud	NGINXPHPFastCGIServer
Nodejs	Omeka	OpenLDAP	OrangeHRM
osCommerce	ownCloud	phpList	PostgreSQL
Prestashop	SilverStripe	SuiteCRM	TKLDev
WordPress

Give them a try and share your feedback

Any problems with any v18.0 appliances, or Confconsole or any of our custom software, please feel free to post in our support forums or lodge an issue on our GitHub Issue Tracker. Comments on this announcement blog post are also an option.

Unfortunately due to huge amounts of spam, we've had to close automated website account approval. So if you don't have an account, please register for one and follow the instructions in the automated account creation email that should be sent out immediately. As noted, please do a guest post (include your support request in your guest post if relevant and I'll move it), then I'll endeavor to approve your account ASAP.

Please note that guest post will need manual approval too. So if you can't see your post, that's probably why.

Looking Ahead

This release is a part of our ongoing effort to deliver robust, secure, and flexible server solutions. We're already working on the next batch of updated appliances and seeing as I was a bit slow announcing this lot, the next batch should not be too far away. The next batch will include the updated Confconsole - with working DNS-01 LE certs, plus a few other bits and pieces. As always we're guided by your feedback and the evolving needs of all our user base. Stay tuned for more updates, and as always, we value your input and support.

Thank you for choosing TurnKey Linux. Happy deployments!

Blog Tags:

v18.0 Stable Release #3 - 10 Updated ISOs & Hub Builds - Proxmox/LXC builds

Jeremy Davis — Thu, 16 Nov 2023 03:54:36 +0000

We have the 3rd v18.0 stable release batch ready to roll (see all v18.x related announcements here). This batch brings the total number of v18.0 stable releases so far to 23! As per usual, it's taking longer than I would like, but they are coming together.

This release consists of 10 freshly updated and tested v18.0 appliances. This release includes all v18.0 LXC/Proxmox builds to date, as well ISOs and Hub builds. A few Proxmox users have reported success with the Proxmox/LXC builds but if you have any feedback, please share. It's still unclear when we might have other builds available, although a VMware user has stuck up their hand to assist with testing; so hopefully we may have them ready soon.

v18.0 Update batch details

Beyond the inclusion of LXC/Proxmox templates, the only things of note for this release are a couple of bugfixes.

The first was the realization that the appliance hash files did not include the key download URL:

1. Verify the authenticity of this file by checking that it is signed with our
   GPG release key:

    $ curl  | gpg --import

It should look like this:

1. Verify the authenticity of this file by checking that it is signed with our
   GPG release key:

    $ curl https://raw.githubusercontent.com/turnkeylinux/common/18.x/keys/tkl-bookworm-images.asc | gpg --import

This was a gross oversight on our behalf and it was only because a user got a corrupt download (which they reported) and in troubleshooting that, I discovered the missing URL. We won't rebuild the previous 13 to fix their hash files, but the updated code will mean all apps moving forward will include that URL. The above code block (the one with the URL after the curl command) can be used if you wish to download the key - the remaining instructions (i.e. checking the hash and that the file is properly signed) are correct.

The second bug, was that Webmin no longer included a log viewer. In previous TurnKey releases (i.e. v17.x and earlier) we used Syslog (technically Syslog-ng) for system logging. However in v18.x (based on Debian 12/Bookworm) Syslog is no longer required. Instead Journalctl (a component of systemd) provides all system logging requirements. However, I completely overlooked that removing Syslog (and Webmin-syslog) left Webmin with no facility for viewing logs! Oops. From this batch forwards, we are including webmin-logviewer - that allows you to view the journal, thus providing the required functionality. As per the hash bug, we're not going to rebuild the previous apps yet, but this batch and all others moving forward will include this package by default.

If you already have any of the other v18.0 appliances that don't already include the Webmin logviewer, you can easily install it from apt - either via Webmin (System >> Software Packages >> Install New Package -> Package from apt "webmin-logviewer") or the Webmin console or CLI (e.g. via SSH):

apt-get update
apt-get install -y webmin-logviewer

v18.0 Apps updated this release

Here are the updated apps in this batch:

BookStack	ConcreteCMS	DokuWiki	NGINXPHPFastCGIServer
Nodejs	Omeka	osCommerce	Prestashop
SilverStripe	WordPress

All v18.0 apps to date

Whilst it's perhaps a bit redundant this time (as we've only release Core & TKLDev previously), as per existing convention, please find all the appliances (in alphabetical order) that have been released for v18.0 so far listed below:

Bagisto	BookStack	ConcreteCMS	Core
DokuWiki	Drupal10	Drupal7	Joomla4
LAMPStack	LAPPStack	MySQL	Nextcloud
NGINXPHPFastCGIServer	Nodejs	Omeka	OrangeHRM
osCommerce	ownCloud	Prestashop	SilverStripe
SuiteCRM	TKLDev	WordPress

Give them a try and share your feedback

We always love feedback. Hearing nice things is always great, and very valuable. Although constructive criticism is probably even better. So if you have any feedback, want to offer a hand with testing or would like to request a specific appliance be prioritized, please post below (guest posts don't require log in, but do require manual approval). Or you can open a new thread in the forums. Please note that posting new threads requires a free website user account; due to spammers, automated approvals have been disabled. So please ping me (via email, as a guest comment here, or over on the specific "welcome" thread) if you're waiting for approval.

If you think that you've found a bug or would like to request a new feature, please post below, in the forums or skip straight on over to our issue tracker (requires free GitHub user account).

Blog Tags:

v18.0 Stable Release #2 - 11 Updated ISOs & Hub Builds

Jeremy Davis — Fri, 13 Oct 2023 03:51:51 +0000

We have the 2nd v18.0 stable release batch ready to roll (see all v18.x related announcements here). This batch brings the total number of v18.0 stable releases so far to lucky number 13! As per usual, it's taking longer than I would like, but they are coming together.

This release consists of 11 freshly updated and tested v18.0 appliances. As per the previous announcements, this release is only ISOs and Hub builds. Once we have a few more published, I plan to circle back and build for Proxmox LXC. It's still unclear when we might have other builds available.

v18.0 Update batch details

Technically, Drupal 10 could "sort of" be considered a new appliance. I mean, we've never had a Drupal 10 appliance before, so in that sense, it's definitely new. Although really it's just a continuation of the Drupal 9 appliance, but with Drupal 10 installed. So in that sense, it's just an update to the Drupal 9 appliance. Speaking of Drupal 9, it's EOL (end of life) is fast approaching (Nov 1st 2023), so we decided to skip that one in v18.x. If you really need Drupal 9, please use the v17.1 release. If you are starting a new Drupal site, then 10 is definitely the version you want!

Despite not having a Drupal 9 (or Drupal 8) appliance(s) anymore, we still have a Drupal 7! Whilst it is NOT recommended to use Drupal 7 for any new projects, we continue to provide the (an updated release of) Drupal 7 appliance for existing users. D7 support has been downgraded, but will now not reach EOL until Jan 5th 2025! Despite that, we recommend where possible to migrate to a newer version of Drupal (or some other platform) ASAP.

Somewhat similar to the situation with D9/D10 (above), we won't be producing a Joomla 3 appliance for v18.x. Joomla 3 is very close to EOL so in v18.x, there will only be a Joomla 4 app. The other app worth a special mention this time around is SuiteCRM. We did not build a SuiteCRM app in v17.x because we had some concerns about the security of the product. It seems that they have addressed our concerns on the new v8.x release of SuiteCRM, so we've added it back to the library for this release.

v18.0 Apps updated this release

Here are the updated apps in all their glory:

Bagisto	Drupal 10	Drupal 7	Joomla 4
LAMP Stack	LAPP Stack	MySQL	Nextcloud
OrangeHRM	ownCloud	SuiteCRM

All v18.0 apps to date

Bagisto	Core	Drupal10	Drupal7
Joomla4	LAMPStack	LAPPStack	MySQL
Nextcloud	OrangeHRM	ownCloud	SuiteCRM
TKLDev

Give them a try and share your feedback

If you think that you've found a bug or would like to request a new feature, please post below, in the forums or skip straight on over to our issue tracker (requires free GitHub user account).

Blog Tags:

Core & TKLDev v18.0 Stable Release

Mattalynn Darden — Thu, 14 Sep 2023 02:03:20 +0000

Happy to announce the stable release of Turnkey v18.0. Took a little longer than I had hoped and there are only two this time. Regardless, we've finally made it to the stable release milestone, at least for Core and TKLDev. I know we'll keep the momentum up and have more v18.0 appliances ready really soon!

In the meantime, these 2 new v18.0 appliances are published to our mirror network and are also available for download direct from their relevant appliance pages (app page links above, direct download links below) or launched directly from the Hub.

Downloads

Core (64bit / amd64 build): 339MB ISO ( changelog , hash file , manifest )

TKLDev (64bit / amd64 build): 419MB ISO ( changelog , hash file , manifest )

Changes of significance

As per previous TurnKey major version releases, the biggest change is the Debian version that this TurnKey release is based on. TurnKey 18.x release is based on Debian 12/Bookworm. As noted in the release candidate announcement the main changes have generally been at the software level, although much of the work will likely not be immediately obvious to an end user. We have done some general software maintenance and implemented some bugfixes and/or code cleanup in our software.

Otherwise, we inherit the updated Debian packages. As per usual, upstream software will be refreshed (where relevant - neither of these apps include upstream third-party software). There has also been a myriad of bug fixes applied and feature requests implemented. You can view the full changes that (will) apply to all v18.x appliances (to both these and the upcoming batches) via the Core v18.0 changes. New in v18.0, all appliances will include a full, exhaustive changelog. I.e. the TKLDev v18.0 changes include the changes for TKLDev, plus all the common Core changes. Previously common changes were only noted in the Core changelog.

Launching from the Hub

For now, the Hub will still launch v17.x appliances by default (mostly because there are only 2 v18.0 app so far). At some point, once we get a few more loaded, we'll make v18.x the default (and eventually remove v16.x altogether). In the meantime, it's really easy to launch these 2 new apps (and the upcoming ones as they get added) in their v18.0 incarnation. You can click this link to launch a new v18.0 server. Otherwise, look for the "18.x" text link in the top right corner when logged into the Hub (just below "logout"):

Where are the other builds?

Due to the time it's taken to get to this point, we've decided to focus primarily on getting the appliances updated and released ASAP. As such, we'll only be publishing ISO and Hub (AWS EC2) builds initially. I know that this won't suit all of our users and we deeply apologize in anticipation. The rationale for this move is that the ISO build can be installed almost anywhere, and the Hub builds provide our primary source of revenue (which keeps the lights on). Furthermore, with all appliances published as ISO, once we update and test the build code for other builds, pumping out the alternate build formats should be fairly straight forward. So, focusing on the ISO and AWS EC2 builds first seems like a reasonable balance between what we'd ideally like (publish everything together) and giving the community the maximum value, at the soonest possible moment.

In the meantime, if you REALLY need/want a specific build, please feel free to share which one. I can't offer any guarantees, but at the very least, I'm more than happy to assist you testing to see if the existing code works (if it does, great - if it needs update, then we'll play it by ear).

Just to be clear, we do intend to publish other builds. I just can't give firm timeframe on when they'll be available. As I say above, if that doesn't suit you, feel free to share your feelings (although please keep it classy). If we get big enough pushback from you, then perhaps we'll need to reassess?

Stuff that didn't make it...

There are always tons of things I try to cram into a new release. I try to close as many issues as possible, focusing first on the bugs, but also trying to implement feature requests and make any other improvements we can along the way. Much of this work occurs behind the scenes and most community members probably have no idea of how much agonizing occurs when it comes to deciding what to keep working on (trying to include), and what to leave until next time.

It's perhaps also worth noting that TKLBAM is still python2 in v18.0. We have made some steps towards porting it to py3, but again we didn't want to hold up v18.0 any longer. Plus, because TKLBAM is such a pivotal and important component, we can't afford to rush it and really do need to ensure that we test the heck out of it! The plan at this point is to pivot back to TKLBAM dev once v18.0 stable release is finished and keep working on the update. Our current intention is to release "TKLBAM 2.0" within the lifetime of v18.x. Initially both TKLBAM & TKLBAM2 will be available side-by-side. Once we get to v19.0 (or perhaps before?) we will have TKLBAM2 only. Obviously, the plan is open to changes, but I wanted to raise the curtain a little, so you have some insight into our plans.

Please help test and give us your feedback.

As per always, we'd be super happy if you gave these appliances a spin. Ideally, we'd love to hear how great they are. But obviously we'd also like to really hear of any issues you hit, any bugs we missed (or new ones we've introduced) or any other thoughts or feedback about v18.0.

If you aren't happy about any features we're missing, or things we should have included but didn't, let us know! Obviously keep it respectful, but we always love feedback! :)

Blog Tags:

Core & TKLDev v18.0 Release Candidates are LIVE!!

Mattalynn Darden — Fri, 21 Jul 2023 22:57:54 +0000

I'm happy to announce the pre-release of the next major version of TurnKey GNU/Linux. The first v18.0 Release Candidates of Core and TKLDev are ready for download, inspection and open for feedback..

Core and TKLDev

As per always, we are pre-releasing our base OS appliance, Core v18.0rc1 and asking the community to give it a spin and let us know what you think. As has become convention, we are also pre-releasing our "build tool in a box", TKLDev v18.0rc1. For the uninitiated, TKLDev is literally the mother of all appliances! It what we use internally to develop, build and run preliminary tests on new appliances.

If you have a particular appliance you are interested in, then building it to ISO and taking it for a test drive would be an awesome experience and a huge help to us and the rest of the community. If you need more specifics on that, please ask and I may even spend some time writing up a blog post on what's required and where things might hiccup (during development). Otherwise, please feel free to browse the TKLDev docs and/or ask questions (here in the comments, or open a new thread on the forums).

Download the RCs and help us test them

Core (64bit / amd64 build): 342MB ISO ( changelog , hash file , manifest )

TKLDev (64bit / amd64 build): 373MB ISO ( changelog , hash file , manifest )

Quick overview of significant changes

You can view further details of specific changes/bugfixes via the relevant changelogs (links above) and I'll do a full outline of the changes when we do the final stable release of v18.0. But in the meantime, here's a quick overview of major changes:

Rebase on Debian 12/Bookworm.
Improvements and bugfixes for Fab, Autoversion, and Bootstrap in TKLDev.
TKLDev now includes TurnKey developer tools tkldev-changelog, fab-rewind & fab-investigate scripts in TKLDev by default.
For those working on future TKLDev transitions, it now requires RELEASE to be set (rather than CODENAME). For general building, it will continue to fallback to the current system (i.e. debian/bookworm for v18.x).
Core updates and improvements for Confconsole, Inithooks, and TKLBAM (mostly code improvements and updates).
Improved IPv6 support for base components.
New Webmin version, which includes a full, interactive terminal client. As such, Webshell (aka shellinabox) has been removed (either use Webmin or SSH instead).
Security hardening improvements through new TurnKey Bookworm keys being implemented in Core.
Enhancing security in Core by automating (and requiring) default pinning for packages from Debian backports.

This release continues our work to bring the TurnKey base more into line with vanilla Debian, whilst still providing ready to use appliances, our special toolset and secret sauce (well not really secret, because you can view the open-source code anytime on GitHub). The idea behind this is that by default our appliances should "just work" but are much more approachable by non-seasoned TurnKey veterans with some Debian/Ubuntu experience.

Expected timeframe for v18.0 stable release appliances

As per always, there is still plenty to be done including quite a few feature requests that I'd love to see included in v18.0. We won't be holding up the release of v18.0 stable appliances any longer than we have to. We will be focused on so at least some of that will almost certainly be delayed until later in the lifetime of v18.x. Some things, still require some work, so whether or not they'll make it in remains to be seen. Regardless, we'll try to get as much in as we can whilst still pushing v18.0 out the door ASAP. We release "when ready" so I can't give any firm commitment on which appliances will be released when. We will however seek to prioritize our base appliances (Core, LAMP, LAPP, NodeJS, etc.) and I hope to have a batch of shiny new releases ready for publishing (as the first batch) in the upcoming months.

Please help test and give us your feedback

As with previous "point-oh" releases, this is a major OS transition. As such, we need plenty of testing! We've already done a fair bit of testing in house, but the more the merrier! So hopefully you get a chance to give the RCs a test drive. We welcome all feedback, especially constructive critique. Please post below, open a new thread in the forums (requires a free website user account) or bugs can be reported directly to the Issue tracker (free GitHub user account required).

If you have any spare cycles and hope to help out, we'd especially love to hear from you. Please reach out if you aren't sure where to start or need some guidance. Look forward to hearing from you! :)

Blog Tags:

v17.x Stable Release #6 - 7 More Updated ISOs & Hub Builds, Plus Bug Fixes

Mattalynn Darden — Wed, 05 Apr 2023 20:57:00 +0000

We have the 6th (and hopefully final) release for 17.x (see previous v17.x announcements here if you wish). There may be some stragglers, but we're fairly close to finishing the v17.x release.

As per the previous announcements, this release is only ISOs, Hub builds, as well as Proxmox LXC. It's still unclear when we might have other builds available.

As per usual, these updated appliances can all be found on our mirror network, downloaded from their relevant pages (links below) or they can be launched directly from the Hub (note that 17.x appliances are now the default).

Bug Fixed Appliances

Turnkey associates have been hard at work to keep all appliances up to date and working as expected. There are 3 initial v17.x releases and 4 bugfixed appliances included in this batch. The bug fixes are applied to fix reported issues and update the upstream software and where required; their dependencies.

Updates for v17.x

Turnkey has 7 freshly updated appliances for to give back to the community.

Domain-controller	GitLab	Invoice-ninja	Nextcloud
((OTRS))CommunityEdition	Rails	Snipe-it

All 17.x Apps to Date

As per existing convention, here are all the appliances (in alphabetical order) that have been released for v17.1+ so far:

Ansible	Asp-net-core	AVideo	B2evolution
Bagisto	Bookstack	Bugzilla	CakePHP
Canvas	CodeIgniter	Concrete-cms	Core
CouchDB	Django	DokuWiki	Domain-controller
Drupal7	Drupal9	e107	Elgg
EspoCRM	EtherPad	FileServer	Foswiki
Gallery	Gameserver	Gitea	GitLab
GNUsocial	iceScrum	Invoice-ninja	Jenkins
Joomla3	Joomla4	LAMPStack	LAPPStack
Laravel	Leantime	LighttpdPHPFastCGIServer	LimeSurvey
Mahara	Mantis	Matomo	Mattermost
MayanEDMS	Mediaserver	MediaWiki	Mibew
Moodle	Mumble	MySQL	Nextcloud
NGINXPHPFastCGIServer	node.js	Observium	Odoo
Omeka	OpenCart	OpenLDAP	OpenVPN
OrangeHRM	osCommerce	((OTRS))CommunityEdition	ownCloud
phpBB	phpList	Plone	PostgreSQL
Prestashop	Processwire	Rails	Redis
Redmine	Roundup	SahanaEden	SilverStripe
SimpleMachines	Snipe-it	Symfony	Syncthing
TKLDev	Tomcat	TomcatonApache	TorrentServer
Tracks	Typo3	Ushahidi	Vanilla
web2py	Wireguard	WordPress	XOOPS
YiiFramework	ZenCart	ZoneMinder

Give them a try and share your feedback

We always love feedback. Hearing nice things is always great, and very valuable. Although constructive criticism is probably even better. So if you have any feedback, want to offer a hand with testing or request a specific appliance be developed or updated, please post below. Or you can open a new thread in the forums (new threads require being logged into a user account; they're free so feel free to sign up).

If you think that you've found a bug or would like to request a new feature, please post below, in the forums or skip straight on over to our issue tracker (requires free GitHub user account).

What's next?

Those of you who have read this far are likely wondering on where we plan to turn our attention now that the initial v17.x release is (more or less) complete. To reward your willingness to read all this, I'm happy to let you know that we are now shifting our attention to the upcoming Debian 12/Bookworm release - which will be the base of our future v18.x TurnKey appliance release. Very little (perhaps none?) of the work we have done so far is public, but work is well underway rebasing TurnKey on the new (upcoming) Debian release. If you are interested in following the progress, please keep an eye out for '18.x-dev' branches in the core components (hosted on our "turnkeylinux" GitHub organisation).

The hope is that we can get the v18.x release ready earlier this time. Hopefully we'll be able to release our usual RC release of Core and TKLDev very soon after Debian 12/Bookworm is released as "stable". We may even look to release "Beta" versions of Core and TKLDev? Note that the idea of "Beta" releases is that they will essentially be the "RC", but before Bookworm is "stable" (i.e. while it's still "Debian testing").

Blog Tags:

v17.1 Stable Release #5 - 17 More Updated & Buggfixed ISOs, Promxox & Hub Builds

Mattalynn Darden — Tue, 07 Mar 2023 20:04:18 +0000

We have the 5th release for 17.1 (see previous v17.x announcements here if you wish). We're fairly close to finishing the initial v17.x release, with only 4 appliances remaining - so one more small batch!

Those with sharp eyes might notice that there are a few more than that not yet updated. Most of them are due to limitations in upstream software (e.g. a number of old Python applications still haven't yet been updated to Python3). These may or may not be reintroduced in the future, depending on a range of factors. If an appliance you are looking for is missing, please be sure to ask.

This release consists of 17 freshly updated and tested v17.x appliances, 7 appliances with their first v17.x release and 10 with bugfixed v17.x releases. As per the previous announcements, this release is only ISOs, Hub builds, as well as Proxmox LXC. It's still unclear when we might have other builds available.

Bugfixed apps

With this release, Turnkey associates have also been working on bugfixes for previously released v17.x appliances. These updates close issues raised via Hub support, forums, upstream developers and our best Turnkey associates. Thanks to all our users for reporting bugs and assisting us to resolve them. The bugfixed updates improve the end user experience, with a number providing improved IPv6 support and a few (PHP based apps) including PHP 8.1 - to faciliate recent or nearly ready updates. E.g. the current version of Bookstack still only requires PHP 7.4, but the next major release (coming soon) - will require PHP 8.1 - so shipping with PHP 8.1 means future updates should be smooth. Thanks to Dan Brown (Bookstack dev) for making the effort to reach out ot us to give us the heads up.

Another bugfixed appliance is Observium. Please see videos below showing Observium set up in action. Please note that the bugfixes referred to in the video are included in the latest Observium appliance bugfix release (see changes for details).

Updates for v17.x

Turnkey Linux has 17 updated and refreshed appliances to give back to the community:

Bookstack	Canvas	EspoCRM	Gitea
Invoice-ninja	Leantime	Matomo	Mattermost
Observium	OpenLDAP	Plone	Snipe-it
TKLDev	Tracks	Ushahidi	Wireguard
ZoneMinder

All v17.x apps to date

As per existing convention, here are all the appliances (in alphabetical order) that have been released for v17.1 so far:

Ansible	Asp-net-core	AVideo	B2evolution
Bagisto	Bookstack	Bugzilla	CakePHP
Canvas	CodeIgniter	Concrete-cms	Core
CouchDB	Django	DokuWiki	Drupal7
Drupal9	e107	Elgg	EspoCRM
EtherPad	FileServer	Foswiki	Gallery
Gameserver	Gitea	GNUsocial	iceScrum
Invoice-ninja	Jenkins	Joomla3	Joomla4
LAMPStack	LAPPStack	Laravel	Leantime
LighttpdPHPFastCGIServer	LimeSurvey	Mahara	Mantis
Matomo	Mattermost	MayanEDMS	Mediaserver
MediaWiki	Mibew	Moodle	Mumble
MySQL	Nextcloud	NGINXPHPFastCGIServer	node.js
Observium	Odoo	Omeka	OpenCart
OpenLDAP	OpenVPN	OrangeHRM	osCommerce
ownCloud	phpBB	phpList	Plone
PostgreSQL	Prestashop	Processwire	Redis
Redmine	Roundup	SahanaEden	SilverStripe
SimpleMachines	Snipe-it	Symfony	Syncthing
TKLDev	Tomcat	TomcatonApache	TorrentServer
Tracks	Typo3	Ushahidi	Vanilla
web2py	Wireguard	WordPress	XOOPS
YiiFramework	ZenCart	ZoneMinder

Give them a try and share your feedback

We always love feedback. Hearing nice things is always great, and very valuable. Although constructive criticism is probably even better. So if you have any feedback, want to offer a hand with testing or request a specific appliance be developed or updated, please post below. Or you can open a new thread in the forums (new threads require being logged into a user account; they're free so feel free to sign up).

If you think that you've found a bug or would like to request a new feature, please post below, in the forums or skip straight on over to our issue tracker (requires free GitHub user account).

Blog Tags:

v17.1 Stable Release #4 - 8 More Updated ISOs & Hub Builds, Plus Bug Fixes

Mattalynn Darden — Thu, 29 Dec 2022 02:50:33 +0000

I hope everyone had a happy holiday season; Turnkey associates have definitely been busy over the holidays. We have a 4th installment of stable v17.1 appliances and the 7th release for 17.x (see the first 6 announcements here if you wish). As previously noted, all of these apps have the v17.0 bugfix applied (many had no official v17.0 release). We're now getting fairly close to finishing the initial v17.x release, with probably one, perhaps 2 more batches.

This release consists of 7 freshly updated and tested v17.1 appliances, and 3 appliances with updated, bugfixed v17.2 releases. As per the previous announcements, this release is only ISOs, Hub builds, as well as Proxmox LXC. It's still unclear when we might have other builds available.

V17.2 bugfix apps

With this release, Turnkey associates have also been working on bugfixes for previously released appliances. First, the Invoice Ninja appliance has been tweaked to close tracker issue #1778 (including a raft of improvements). Next, the Leantime appliance has also had additional work done to close a related tracker issue #1784 and its issues. Lastly, the OTRS appliance has been updated and tweaked to close the related tracker issue #1783. These updates have been worked on to close issues from Hub support, forums, and our best Turnkey associates, and overall improve the how the end user interacts with the appliances.

Updates for v17.x

Turnkey Linux has 10 updated and refreshed appliances to give back to the community:

CouchDB	EtherPad	Faveo-helpdesk	Invoice-ninja
Leantime	osCommerce	((OTRS))CommunityEdition	SahanaEden
Symfony	web2py

All v17.x apps to date

As per existing convention, here are all the appliances (in alphabetical order) that have been released for v17.1 so far:

Ansible	Asp-net-core	AVideo	B2evolution
Bagisto	Bookstack	Bugzilla	CakePHP
CodeIgniter	Concrete-cms	Core	CouchDB
Django	DokuWiki	Drupal7	Drupal9
e107	Elgg	EspoCRM	EtherPad
Faveo-helpdesk	FileServer	Foswiki	Gallery
Gameserver	Ghost	Gitea	GNUsocial
iceScrum	Invoice-ninja	Jenkins	Joomla3
Joomla4	LAMPStack	LAPPStack	Laravel
Leantime	LighttpdPHPFastCGIServer	LimeSurvey	Mahara
Mantis	Mattermost	MayanEDMS	Mediaserver
MediaWiki	Mibew	Moodle	Mumble
MySQL	Nextcloud	NGINXPHPFastCGIServer	node.js
Observium	Odoo	Omeka	OpenCart
OpenVPN	OrangeHRM	osCommerce	((OTRS))CommunityEdition
ownCloud	phpBB	phpList	PostgreSQL
Prestashop	Processwire	Redis	Redmine
Roundup	SahanaEden	SilverStripe	SimpleMachines
Snipe-it	Symfony	Syncthing	Tomcat
TomcatonApache	TorrentServer	Typo3	Vanilla
web2py	WordPress	XOOPS	YiiFramework
ZenCart	ZoneMinder

Give them a try and share your feedback

We always love feedback. Hearing nice things is always great, and very valuable. Although constructive criticism is probably even better. So if you have any feedback, want to offer a hand with testing or request a specific appliance be developed or updated, please post below. Or you can open a new thread in the forums (new threads require being logged into a user account; they're free so feel free to sign up).

If you think that you've found a bug or would like to request a new feature, please post below, in the forums or skip straight on over to our issue tracker (requires free GitHub user account).

Blog Tags:

v17.1 Stable Release #3 - 14 more ISOs & Hub builds

Mattalynn Darden — Wed, 26 Oct 2022 23:53:01 +0000

This will be technically the 3rd installment of stable v17.1 appliances and the 6th release for 17.x (see the first 5 announcements here if you wish). As previously noted, all of these apps have the v17.0 bugfix applied (many had no offical v17.0 release). We're now getting fairly close to finishing the initial v17.x release, with probably one, perhaps 2 more batches.

This release consists of 14 updated and tested appliances. As per the previous announcements, this release is only ISOs, Hub builds, as well as Proxmox LXC. It's still unclear when we might have other builds available.

New Appliances

This time around, we have one brand new shiny appliance to add to the library. It's a major update for one of our most popular and long running appliances, Joomla!:

Joomla4 - Joomla! - award-winning Content Management System (CMS)

Joomla! is an award-winning Content Management System (CMS) for building websites as well as a Model-view-controller (MVC) Web Application Development framework. Features include page caching to improve performance, RSS feeds, printable versions of pages, news flashes, blogs, polls, website searching, and language internationalization.

Additionally, the appliance previously named Concrete5 has been renamed to Concrete-CMS during the v.17.x update.

Updates for v17.x

Turnkey Linux has 14 updated and refreshed appliances to give back to the community:

Bagisto	Jenkins	Joomla3	Joomla4
MayanEDMS	Moodle	MySQL	Nextcloud
OpenVPN	phpBB	PostgreSQL	Redis
Snipe-it	WordPress

All v17.x apps to date

As per existing convention, here are all the appliances (in alphabetical order) that have been released for v17.1 so far:

Ansible	Asp-net-core	AVideo	B2evolution
Bagisto	Bookstack	Bugzilla	CakePHP
CodeIgniter	Concrete-cms	Core	Django
DokuWiki	Drupal7	Drupal9	e107
Elgg	EspoCRM	FileServer	Foswiki
Gallery	Gameserver	Ghost	Gitea
GNUsocial	iceScrum	Invoice-ninja	Jenkins
Joomla3	Joomla4	LAMPStack	LAPPStack
Laravel	Leantime	LighttpdPHPFastCGIServer	LimeSurvey
Mahara	Mantis	Mattermost	MayanEDMS
Mediaserver	MediaWiki	Mibew	Moodle
Mumble	MySQL	Nextcloud	NGINXPHPFastCGIServer
node.js	Observium	Odoo	Omeka
OpenCart	OpenVPN	OrangeHRM	((OTRS))CommunityEdition
ownCloud	phpBB	phpList	PostgreSQL
Prestashop	Processwire	Redis	Redmine
Roundup	SilverStripe	SimpleMachines	Snipe-it
Syncthing	Tomcat	TomcatonApache	TorrentServer
Typo3	Vanilla	WordPress	XOOPS
YiiFramework	ZenCart	ZoneMinder

Give them a try and share your feedback

We always love feedback. Hearing nice things is always great, and very valuable. Although constructive criticism is probably even better. So if you have any feedback, want to offer a hand with testing or request a specific appliance be developed or updated, please post below. Or you can open a new thread in the forums (new threads require being logged into a user account; they're free so feel free to sign up).

If you think that you've found a bug or would like to request a new feature, please post below, in the forums or skip straight on over to our issue tracker (requires free GitHub user account).

Blog Tags:

v17.1 Stable Release #2 - 24 more ISOs, Hub builds and Proxmox/LXC

Mattalynn Darden — Thu, 13 Oct 2022 00:28:56 +0000

After a bit of a delay - due to other competing priorities; such as our webserver dying - the v17.x release continues. As per previous updates all these appliances are being built as v17.1.

Whilst this is the 2nd installment of stable v17.1 appliances, it is also the 5th release blog post for 17.x appliance updates (see the first 4 announcements here if you wish).

This release consists of 24 tested and updated appliances. Building on the previous v17.x releases, this release contains not only ISOs and Hub builds, but also Proxmox/LXC builds. It's still unclear when we might have other builds available.

As per usual, these updated appliances can all be found on our mirror network, downloaded from their relevant pages (links below) or they can be launched directly from the Hub (look for the 17.x text link - in the top right corner).

New Appliance - ProcessWire

This time around, we have a brand new shiny appliance to add to the library. Thanks to community member @daymickcorr:

ProcessWire - ProcessWire is a free content management system (CMS) and framework (CMF) built to save you time and work the way you do. With all custom fields, a secure foundation, proven scalability and performance, ProcessWire connects all of your content seamlessly, making your job fast, easy and fun. Extendable with custom developed plugins, or search the available third party ProcessWire modules.

Additionally, the appliance previously named Concrete5 has been renamed to "Concrete CMS" during the v.17.x update (following upstream's lead).

Updates for v17.x

Turnkey Linux has 24 updated and refreshed appliances to give back to the community:

Bugzilla	Concrete-cms	EspoCRM	FileServer
Gameserver	Gitea	GNUsocial	Invoice-ninja
LAPPStack	Mediaserver	Mumble	Observium
Odoo	((OTRS))CommunityEdition	Processwire	Redmine
SimpleMachines	Tomcat	TomcatonApache	TorrentServer
Typo3	YiiFramework	ZenCart	ZoneMinder

All v17.x apps to date

As per existing convention, here are all the appliances (in alphabetical order) that have been released for v17.0 so far:

Ansible	Asp-net-core	AVideo	B2evolution
Bookstack	Bugzilla	CakePHP	CodeIgniter
Concrete-cms	Core	Django	DokuWiki
Drupal7	Drupal9	e107	Elgg
EspoCRM	FileServer	Foswiki	Gallery
Gameserver	Ghost	Gitea	GNUsocial
iceScrum	Invoice-ninja	LAMPStack	LAPPStack
Laravel	Leantime	LighttpdPHPFastCGIServer	LimeSurvey
Mahara	Mantis	Mattermost	Mediaserver
MediaWiki	Mibew	Mumble	NGINXPHPFastCGIServer
node.js	Observium	Odoo	Omeka
OpenCart	OrangeHRM	((OTRS))CommunityEdition	ownCloud
phpList	Prestashop	Processwire	Redmine
Roundup	SilverStripe	SimpleMachines	Syncthing
Tomcat	TomcatonApache	TorrentServer	Typo3
Vanilla	XOOPS	YiiFramework	ZenCart
ZoneMinder

Reminder that there is no v17.x Drupal 8 appliance. That is because Drupal 8 reached EOL (end of life) November last year. Drupal 7 was originally intended to also reach EOL then too, but was extended until November 2022. It has since been extended again, with the new EOL date: Nov 1st, 2023.

That's good news for existing Drupal 7 users, but we do not recommend that anyone starts a new project on Drupal 7. New Drupal project should use Drupal 9 (or the newer Drupal 10 - which we will hopefully provide an appliance for soon).

Give them a try and share your feedback

We always love feedback. Hearing nice things is always great, and very valuable. Although constructive criticism is probably even better. So if you have any feedback, want to offer a hand with testing or request a specific appliance be developed or updated, please post below. Or you can open a new thread in the forums (new threads require being logged into a user account; they're free so feel free to sign up).

If you think that you've found a bug or would like to request a new feature, please post below, in the forums or skip straight on over to our issue tracker (requires free GitHub user account).

Blog Tags:

v17.1 - The v17.x release continues with bugfixed builds

Jeremy Davis — Tue, 17 May 2022 03:19:10 +0000

After a bit of hiccup, I am pleased to be back to announce the ongoing release of v17.x appliances. Because of the bug, the previously released v17.0 appliances have been patched with a bugfix and re-released as v17.1. They also include all the latest Debian packages.

Updated apps, new for v17.x

When the bug hit, there were 15 updated v17.0 appliances that had been built ready for release, but not yet published. We have patched these v17.0 ISOs too and included them in this v17.1 bugfix release. Here are the 15 new appliances to be released as v17.1:

B2evolution	CakePHP	CodeIgniter	e107
Elgg	Foswiki	Gallery	Ghost
Laravel	Leantime	Mattermost	Mibew
Omeka	ownCloud	Prestashop

Bugfixed v17.1 appliances

As per convention, and perhaps even more important that usual, here (in alphabetical order) are all the current v17.1 appliances:

Ansible	Asp-net-core	AVideo	B2evolution
Bookstack	CakePHP	CodeIgniter	Core
Django	DokuWiki	Drupal7	Drupal9
e107	Elgg	Foswiki	Gallery
Ghost	iceScrum	LAMPStack	Laravel
Leantime	LighttpdPHPFastCGIServer	LimeSurvey	Mahara
Mantis	Mattermost	MediaWiki	Mibew
NGINXPHPFastCGIServer	node.js	Omeka	OpenCart
OrangeHRM	ownCloud	phpList	Prestashop
Roundup	SilverStripe	Syncthing	TKLDev
Vanilla	XOOPS

What we've done and the implications

Essentially, we've just unpacked the ISOs and applied the bugfix as noted in the bug alert post. All available Debian updates were also installed and then the whole shebang repackaged as 'v17.1' iso.

So whilst v17.1 appliances are fixed and do not include the issue, the root cause of the bug is actually in our build infrastructure, namely fab. The bug causes the result noted in the blog post. So you could say that we've fixed the symptom, but not yet fixed the root problem.

The implication is that the bug still exists in TKLDev v17.1. So if you build ISOs with TKLDev, your ISOs will still be affected by this bug. Unfortunately, it won't be immediately obvious. It will only become a problem once the kernel is updated. We're working on a proper fix and once we have a good one and are happy that the root issue is resolved, we will release an updated TKLDev.

In the meantime, if you are building ISOs, or testing alternate builds (with the exception of LXC/PRoxmox builds - which don't include a kernel) then I suggest that you include the following at the bottom of your conf script:

apt-get update
apt-get remove -y live-tools
apt-get install --reinstall -y initramfs-tools
apt-get install -y di-live live-tools

This is only a temporary measure and once we fix fab, you will be able to install the bugfix via apt (and remove the above code from your conf script- or start again with a new TKLDev). This is far from ideal, but allows us to push forward with the v17.x release, whilst take the time to ensure a proper fix.

Feedback encouraged

Please let us know in the comments (below) how you go with these updated appliances. If you are using TKLDev to build and have any further questions, please do not hesitate to ask. All feedback welcome.

Blog Tags:

Bug Alert! v17.0 security updates kernel. Reboot results in kernel panic.

Jeremy Davis — Mon, 09 May 2022 08:57:07 +0000

2022-05-17 Update: All affected appliances have now been bugfixed and rebuilt as v17.1. The v17.x release will continue, with all new appliances to be released as v17.1.

As first reported by user ZZRabbit, in our forums, there is a serious bug in TurnKey v17.0! Once security updates are installed on v17.0 appliances (namely a kernel update), a reboot will result in a kernel panic. Others have since confirmed the issue and I have a workaround. Other issues have been noted, but they seem to be unique to specific users, so I'll only cover the confirmed resolution for now.

This post will be clearly updated with additional info as it comes to hand.

Am I affected?

This issue only affects v17.0 appliances. If you are running an earlier or different version, then you are not affected. If you are running v17.0, then I suggest that you assume you are affected. The fix (below) will not do any harm if you aren't affected (will fail on earlier releases).

Don't reboot yet! Apply this fix first.

Before you reboot your v17.0 server, please be sure to run these commands:

apt install --reinstall -y initramfs-tools
dpkg-reconfigure linux-image-5.10.0-14-amd64

That should ensure that the issue does not affect you.

Reboot to be sure:

reboot && exit

What if it's already broken?

If your server already is broken, then please reboot back into the old kernel. You can do that within the early boot. On the "GNU Grub" boot screen (blue options box on a black background), hit the down arrow to select "Advanced options for Debian GNU/Linux", then hit enter. Then hit the down arrow twice, to select the older kernel, it should be "5.10.0-13" (NOT the one that says "recovery mode"). Then hit enter to boot. It should "just work'. Run the above noted fix and you should be good. Reboot into the new kernel to be sure.

What went wrong?

I still haven't specifically pinned down the exact cause. But it's clear that this issue is a result of a bug within our build system (lots of infrastructure code upgrades happened between v16.x & v17.0). I will update with more info once I am certain.

Still having problems? Want to report success?

If you are still having problems related to rebooting v17.0 with the new kernel, please post below in the comments. Please feel free to also report success.

What happens next?

Well, once you have applied the above fix and confirmed that you can successfully reboot into the new kernel, then you can keep using your server. The above fix resolves the underlying bug, so you can continue to use your v17.0 for the expected lifetime of v17.x.

Please note that there is a chance that there may be other repercussions of this bug that we're not yet aware of. Regardless, the above resolves this specific kernel update issue. I will thoroughly investigate the root cause and share any further information if/as it comes to light.

As for the v17.0 release in general, I will be pausing that for the moment. I have removed all the v17.0 build download links from the relevant appliance pages (the images are still on the mirror for now). I will also add a note to the top of all the v17.0 blog post announcements so users are aware.

The next step will be to pin-point the bug in our build tools. I've already got a fair idea where it's occurred, but not yet why. Only once I am completely sure I understand what happened, can I also be sure of what (if any) other implications there may be. If any further potential issues are discovered, I'll post back with a relevant workaround/fix.

Once I am sure that I have clarity on the bug and a fix for any and all relevant issues, the next step will be fix the existing v17.0 appliances and re-release them as v17.1. This will mean many appliances will not see a v17.0 release, but that's ok. There are also a few more appliances that have been updated, but not yet published/released, they will also make it into this "rebuilt as v17.1" batch. So it will be close to half the library.

When we've got to that point, we will essentially be back to where we were before this bug cropped up. I'll then return my attention to squashing this bug in the build code (if I haven't already). Once we've confirmed that all is well again there, we will resume the v17.x release, just that the rest will be v17.1.

Blog Tags:

Do you love TurnKey? Have a few spare cycles and want to help out?

Jeremy Davis — Sat, 07 May 2022 03:26:01 +0000

2022-05-17 Update: Please note that due to a bug, all v17.0 appliances have now been bugfixed and rebuilt as v17.1. The v17.x release will continue, with all new appliances to be released as v17.1.
Important note: As noted in the v17.1 release announcement the root issue that caused the kernel panic bug still exists in TKLDev! This DOES NOT affect building alternate builds from "official" v17.1 apps, but will affect any ISOs that you build with TKLDev v17.0 or v17.1. The bugfix/v17.1 announcement includes (temporary) code you can add to the conf.d/main script to resolve the issue. We're still working on a proper fix. Once it's done, we'll release a new version of 'fab', and a new release of TKLDev. Existing v17.x TKLDev deployments will be able to install the bugfixed version of 'fab'. More info as it comes to hand.

So do you love TurnKey? Or even just like it quite a bit?! And have some time and energy and a desire to help out? If so, have I got a job for you! :)

As many of you would be aware, we're still plugging away at the well overdue v17.0 release - if you're not, please check out the most recent announcement (at the time of writing). So far, we've only produced 25, but lots more are well on the way behind the scenes. Unfortunately, our resources are limited, so we're prioritising ISO and Hub builds for now. That means that a number of our "optimized" or "alternate" buildtypes will not be available until we can circle back to them. As the buildcode for the different buildtypes is updated for v17.0, we can batch process all the v17.0 ISOs that are available.

Buildtypes remaining

I'll try to keep this list below updated but as of the time of writing this is the status of the optimized/alternate buildtypes:

Updates
2022-05-11 - Proxmox/LXC - updated code merged into master.

Hub - working and being progressively published
Proxmox/LXC - merged into master - working but needs more testing
VM (VMDK & OVA) - untested
OpenStack (KVM) - untested
Xen (HVM) - untested
Docker - untested

This is where you can come in

So if your favourite buildtype (above) isn't yet available for v17.0, here's how you can help push it forward. You'll be helping yourself, but also helping TurnKey and all other users.

What if I can't code? What if I don't know git or other weird commands?

No coding experience required. If you've run commands on a Linux terminal (and can google), then that's enough to get started! Most of the build code is bash script, which is essentially just a heap of commands in a file. Plus files can be overlaid - but let's not dig into that too much just yet.

I'm happy to coach (in the comments below). Even if you just copy/paste the relevant commands and report back with any error messages - or stories of success, that is extremely useful. Just doing that much cuts down the time it takes us in development and testing, which means the sooner they'll be available for everyone.

What you'll need

You'll need access to the environment that the particular build requires, although I guess that's probably both obvious and likely.

You'll also need to install TKLDev as a VM. One easy way is to just use VirtualBox (or similar) on a desktop. See our VirtualBox install tutorial for details (install from v17.0 TKLDev ISO). Once you have TKLDev installed and running, you could build ISOs - ours, or your own custom one. But that's not what I'm covering here. Instead, we'll look at converting an existing ISO to a different buildtype. This could be your own custom ISO, or one that we have already built, but I'll only focus on building from TurnKey ISOs (including downloading them).

Doing a build

First up, you'll need to move to buildtasks and do the simple setup. The default config should be fine to get started:

cd buildtasks
cp -R config.example config

Then do a build. For an untested build, I suggest starting with Core. Core is the most simple appliance with the least moving parts, so the most likely to work and/or need the least work. If the buildtype you wish to work on is already (reportedly) working, then testing other appliances is a probably better place to start. I'll use Core for my example, but please feel free to update the commands to build other appliances. I recommend only building v17.0 appliances at this point.

If you want to test the default ('master' branch) then you can just run the relevant script. E.g. to attempt a build of Core to VM (VMDK and OVA):

./bt-vm core-17.0-bullseye-amd64

How to pull in updated code for testing aka getting 'gitty'

Git micro primer

We use git for code version control. You don't need to know lots about it, but it's probably worth being aware of a few basic terms and their meaning:

Commit: a "commit" is the code at a point in time. It is a set of changes applied to the commit before it (it's "parent"). Each one has a "commit id" which is a SHA-1 hash. It also has a message. The current commit can also be referred to as 'HEAD'. A new "commit" occurs when a new change to the code is saved (via the "git commit" command).
Branch: a "branch" is a collection of one or more "commits". The default branch (at least for TurnKey projects) is usually 'master'. Development usually (and generally should) happens in alternate branch names. Descriptive branch names are recommended.
Repository: a "repository" (in the context of git) is a directory including a .git directory and whatever else is being stored in it.
Remote: a "remote" is a remote git repository. TurnKey uses GitHub, but there are lots of other options.
Fetch: 'fetching' is the process of updating the local store of info about a "remote".
Checkout: you can "checkout" an alternate "branch" (either local or remote, old or new).
Stash: "stash' updated code that hasn't yet been committed, particular useful if you want to try someone else's "branch".

Checkout a testing branch and do your build

Often during development, there may be updated code that is still in a development branch and has not yet been merged into master. If you wish to test updated code that is not yet merged, you'll need to fetch it and the do a checkout. I'll use the Proxmox/LXC update as an example. This example has now been merged into 'master', so will no longer work.

First, add my GitHub account as a remote and fetch my available branches and checkout my 'fix-1636' branch:

git remote add jeremy https://github.com/JedMeister/buildtasks.git
git fetch jeremy
git checkout fix-1636

Now you can test my update for the Proxmox/LXC build for the new BookStack appliance:

./bt-container bookstack-17.0-bullseye-amd64

You'll find the result in the /mnt/builds/ sub-directory. E.g. for bt-container: /mnt/builds/container/

Let me know how you go.

I'm hoping to keep this post updated as we work through v17.0. So please share your experience in the comments below. I'll aim to update info as things change and I'll probably add further info/sections here, especially if there are common issues and/or troubleshooting info that will help others (without having ot read all hte comments). So please have a go and/or ask any questions you might have and I'll do my best to guide you.

Blog Tags: