Skip to content

Commit 571df1a

Browse files
authored
Merge pull request #221 from eshtek/dev
dev -> main
2 parents ca8fb3c + b12ae78 commit 571df1a

6 files changed

Lines changed: 119 additions & 1 deletion

File tree

docs/.vitepress/sidebar.ts

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,7 @@ const sidebar: DefaultTheme.SidebarItem[] = [
129129
collapsed: true,
130130
items: [
131131
{ text: 'All Posts', link: '/blog/' },
132+
{ text: '1.0 Local Rollout Complete', link: '/blog/2026-04-21' },
132133
{ text: 'HexOS 1.0 Has Arrived', link: '/blog/2026-04-02' },
133134
{ text: 'Apps Overhaul', link: '/blog/2025-12-26' },
134135
{ text: 'HexOS Roadmap Update', link: '/blog/2025-11-26' },
@@ -154,6 +155,7 @@ const sidebar: DefaultTheme.SidebarItem[] = [
154155
collapsed: true,
155156
items: [
156157
// auto-generated-release-notes-start
158+
{ text: '2026-04-21', link: '/release-notes/command-deck/2026-04-21' },
157159
{ text: '2026-03-27', link: '/release-notes/command-deck/2026-03-27' },
158160
{ text: '2026-03-24', link: '/release-notes/command-deck/2026-03-24' },
159161
{ text: '2026-01-21', link: '/release-notes/command-deck/2026-01-21' },

docs/blog/2026-04-21.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# HexOS 1.0 Local Rollout Complete
2+
**April 21, 2026**
3+
4+
*By Jerod Fritz*
5+
6+
Three weeks ago we [announced HexOS 1.0](/blog/2026-04-02). Today we can confirm that every existing customer has been migrated to [HexOS Local](/blog/2025-11-25), the new locally hosted architecture that powers it.
7+
8+
## What We Actually Pulled Off
9+
10+
Migrating thousands of production servers to an entirely new architecture without asking anyone to reinstall, without scheduling downtime, and without losing a single byte of data is not a small thing. It is the kind of work that, in most organizations, gets planned in quarters and executed over weekends with maintenance windows. We did it incrementally, by order of purchase, while every server stayed online.
11+
12+
Each migration required automated DNS provisioning, SSL certificate generation via a formalized partnership with Let's Encrypt, and installation of the HexOS Local app, all orchestrated from our cloud infrastructure and triggered per user. The legacy hosted backend has been fully deprecated. New customers now onboard directly to Local.
13+
14+
This was building a plane while flying it, and the plane landed.
15+
16+
## Why It Matters
17+
18+
When we first [previewed the Local architecture](/blog/2025-11-25) last November, the pitch was simple: your Command Deck should talk to your hardware, not to us. That is now reality for every HexOS user.
19+
20+
The majority of your day-to-day interactions with Command Deck now go directly to your server. Pages load faster, app installs respond instantly, and the interface feels like the native tool it was always meant to be. Some operations, like initial setup, monitoring, and network recovery, still pass through our cloud services to keep things running smoothly. But the heavy lifting is local.
21+
22+
Just as importantly, this architecture is the foundation for everything ahead. Smarter app preconfiguration, buddy backups, and features that simply were not possible when every action had to round-trip through the cloud are now on the table.
23+
24+
## Post-Launch Stabilization
25+
26+
The weeks since launch have been heads-down on stabilization. We have shipped over 25 production deploys in that time. We resolved a race condition where servers rebooted without a network connection would fail to start Docker, causing the setup wizard to re-appear. We fixed app version display mismatches that made updates look like downgrades. We caught and suppressed an erroneous TrueNAS 26.0-BETA.1 update notification before it could cause real damage. We tuned session handling, fixed dashboard button states, and restored custom apps that had disappeared after migration.
27+
28+
The full list of fixes is in the [release notes](/release-notes/command-deck/2026-04-21).
29+
30+
## New Customer Experience
31+
32+
With 1.0 out the door, we have refreshed what new customers see when they purchase HexOS. The home page reflects 1.0 availability, the FAQ confirms it is live, the cart page is cleaner, and new buyers now receive a welcome email with step-by-step getting started links and an invitation to join the community.
33+
34+
## What's Next
35+
36+
With Local behind us, the team is focused on:
37+
38+
- **Expanding the curated apps catalog** with more one-click installs and deeper preconfiguration. This is the highest priority coming out of 1.0.
39+
- **Buddy Backups (1.1)** for peer-to-peer encrypted replication between HexOS servers.
40+
- **VM support (1.2)** for creating and managing virtual machines from the HexOS interface.
41+
- **System health improvements** with guided action paths for degraded states and drive failures.
42+
- **Documentation overhaul** by consolidating community guides from our forums and other sources into [docs.hexos.com](https://docs.hexos.com) as a single, comprehensive knowledge base for all things HexOS.
43+
- **New website and ecommerce experience** to support subscription pricing when we sunset lifetime access. Once the Early Access lifetime price is gone, it is gone forever. If you have been on the fence, now is the time.
44+
45+
<div style="text-align: center; margin: 2rem 0;">
46+
<a href="https://hexos.com" target="_blank" style="display: inline-block; padding: 12px 24px; background-color: #7F35B2; color: white; text-decoration: none; border-radius: 6px; font-weight: 600; transition: background-color 0.2s;">
47+
Buy Now at Early Access Price
48+
</a>
49+
</div>
50+
51+
## Thank You
52+
53+
Thank you to everyone who helped us identify and reproduce issues during the rollout. Your willingness to share logs, test edge cases, and provide detailed reports made this a smoother transition for everyone.
54+
55+
We are also bolstering our communication and customer support by rolling out our public [Discord server](https://discord.gg/fCW2htvYdz). Whether you have a question, want to share feedback, or just want to hang out with the team and other HexOS users, find us there anytime.

docs/blog/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ Stay up to date with the latest news and updates from the HexOS team.
44

55
## 2026
66

7+
- [HexOS 1.0 Local Rollout Complete - April 21, 2026](/blog/2026-04-21)
78
- [HexOS 1.0 Has Arrived - April 2, 2026](/blog/2026-04-02)
89

910
## 2025
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
# April 21, 2026 - HexOS 1.0 Local Rollout Complete
2+
3+
All existing customers have been migrated to HexOS Local. New customers now onboard directly to the Local platform. The legacy hosted backend has been deprecated. For the full story, see the [blog post](/blog/2026-04-21).
4+
5+
### Local Migration
6+
7+
- Completed incremental migration of all users by order of purchase
8+
- Resolved an issue where newly claimed servers would connect to the legacy backend if the user's account had already been migrated
9+
- Fixed edge case where servers rebooted without network connectivity would fail to start Docker, causing the setup wizard to re-appear
10+
- Servers that lose connectivity during boot now recover more gracefully once the network is restored
11+
- Added recovery retry logic for transient failures during HexOS Local provisioning
12+
- Formalized partnership with Let's Encrypt to issue per-server SSL certificates, gradually replacing the shared wildcard certificate used during initial migration
13+
14+
### Authentication & Session
15+
16+
- Added a "Remember Me" option on the Local login screen to reduce frequent re-authentication. Continuing to tune session duration based on feedback.
17+
- Migrated legacy user preferences (Expert Mode, Experimental Features) so they persist after the Local transition
18+
- Renamed "Username" to "Email" on the authentication screen
19+
- Made the "Create Account" link easier to spot during login
20+
21+
### Reliability & Recovery
22+
23+
- Added semaphore-based connection handling to prevent thundering herd issues when many servers reconnect simultaneously
24+
- Improved handling of TrueNAS disconnections while waiting on Docker status calls
25+
- Added job tracking IDs to Docker update tasks to prevent stale task states
26+
- Improved Sentry error fingerprinting for more accurate issue grouping
27+
- Added server lifecycle logging for diagnosing provisioning and recovery issues
28+
29+
### Apps & Catalog
30+
31+
- Fixed app version display mismatch where update prompts showed the install script version instead of the app version
32+
- Prevented multi-step dialogs from closing on outside click during app operations
33+
- Scheduled catalog sync now includes deprecation metadata and script updates
34+
- Removed erroneous TrueNAS 26.0-BETA.1 update notification
35+
- Resolved an issue where curated apps temporarily disappeared from the catalog
36+
- Fixed custom apps installed via TrueNAS not appearing in the HexOS dashboard after Local migration
37+
38+
### Compatibility
39+
40+
- Changed compile target to support older CPUs that were previously failing to run the Local app
41+
- Added diagnostic tools for fetching app logs from crashed or incompatible environments
42+
- Added warnings when a server is running a TrueNAS version too old for full HexOS compatibility (Supported: >=24.10.2.2, <26.0.0). Early adopters still on 24.10.0 or 24.10.2.1 will need to upgrade manually. Follow our [upgrade guide](/troubleshooting/common-issues/UpgradingHexOS24).
43+
44+
### UI & UX
45+
46+
- Fixed dashboard launch buttons greyed out when accessing via IP instead of local.hexos.com hostname
47+
- Fixed button styling and state issues across app, server, and pool pages
48+
- Cleaned up dead links and improved redirect behavior when resetting or unclaiming servers
49+
- Ensured Samba service is properly enabled and started during provisioning
50+
- Adjusted compatibility for the new AppUpdate alert class pattern that regressed update presentation
51+
52+
### New Customer Experience
53+
54+
- Updated home page to reflect 1.0 availability and clarified Early Access pricing language
55+
- Revised FAQ to confirm HexOS 1.0 is live
56+
- Simplified cart page with clearer purchase details
57+
- New welcome email with getting started links, support contacts, and community invitation
58+
59+
**NOTE:** All of these updates are applied automatically to your Command Deck. You may need to clear your cache. Help with clearing your cache is available [here](/troubleshooting/common-issues/ClearCache).

docs/release-notes/command-deck/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ For users who are actively connected during an update, there may be a brief down
1111
<!-- auto-generated-year-sections-start -->
1212
## 2026 Releases
1313

14+
- [**2026-04-21**](./2026-04-21) - HexOS 1.0 Local Rollout Complete
1415
- [**2026-03-27**](./2026-03-27) - Hotfix : Apps Newly Curated
1516
- [**2026-03-24**](./2026-03-24) - Local Foundations & UI Polish
1617
- [**2026-01-21**](./2026-01-21) - Mobile Dialogs, App Lifecycle, Polish, HexOS Local Prep

docs/release-notes/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ The Command Deck is the HexOS web interface. Updates are automatically deployed
88

99
**[View Command Deck Release Notes →](/release-notes/command-deck/)**
1010

11-
**Latest:** [2026-03-27Hotfix : Apps Newly Curated](/release-notes/command-deck/2026-03-27)
11+
**Latest:** [2026-04-21HexOS 1.0 Local Rollout Complete](/release-notes/command-deck/2026-04-21)
1212

1313
## TrueNAS
1414

0 commit comments

Comments
 (0)