-
{
- if (await useConfirm.openConfirmDialog({
- title: 'Update QuickStack',
- description: 'This action will restart the QuickStack service and installs the lastest version. It may take a few minutes to complete.',
- okButton: "Update QuickStack",
- })) {
- Toast.fromAction(() => updateQuickstack());
- }
- }}>
-
Installed: {currentVersion ?? 'unknown'}
+
+
+
+
+ Canary Channel
+
+
+ Get early access to experimental features and updates (not recommended for production environments).
+
+
+
{
+ // Show warning when enabling canary channel
+ if (checked) {
+ const confirmed = await useConfirm.openConfirmDialog({
+ title: 'Enable Canary Channel',
+ description: 'Canary channel provides early access to experimental features and updates. These versions may contain bugs, make your QuickStack cluster unusable and are not recommended for production environments. Are you sure you want to continue?',
+ okButton: "Enable Canary Channel",
+ });
+
+ if (!confirmed) {
+ return;
+ }
+ }
+ try {
+ setLoading(true);
+ Toast.fromAction(() => setCanaryChannel(checked));
+ } finally {
+ setLoading(false);
+ }
+ }}
+ />
+
+
+
+
+ {useCanaryChannel ?
+
+ Cannot check for updates while on the canary channel.
+
:
+
+ {newVersionInfo ? 'Update to the latest version' : 'You are up to date'}
+
}
+
+
+
;
}
\ No newline at end of file
diff --git a/src/app/sidebar-client.tsx b/src/app/sidebar-client.tsx
index 9188ff25..7f1241fb 100644
--- a/src/app/sidebar-client.tsx
+++ b/src/app/sidebar-client.tsx
@@ -32,44 +32,16 @@ import { useRouter } from "next/router"
import { useEffect, useState } from "react"
import QuickStackLogo from "@/components/custom/quickstack-logo"
import { UserGroupUtils } from "@/shared/utils/role.utils"
-
-
-const settingsMenu = [
- {
- title: "Profile",
- url: "/settings/profile",
- icon: User,
- },
- {
- title: "Users & Groups",
- url: "/settings/users",
- icon: User2,
- adminOnly: true,
- },
- {
- title: "S3 Targets",
- url: "/settings/s3-targets",
- icon: Settings,
- adminOnly: true,
- },
- {
- title: "Cluster",
- url: "/settings/cluster",
- adminOnly: true,
- },
- {
- title: "QuickStack Settings",
- url: "/settings/server",
- adminOnly: true,
- },
-]
+import { GithubReleaseInfo } from "@/server/adapter/github.adapter"
export function SidebarCient({
projects,
- session
+ session,
+ newVersionInfo
}: {
projects: (Project & { apps: App[] })[];
session: UserSession;
+ newVersionInfo?: GithubReleaseInfo;
}) {
const path = usePathname();
@@ -77,6 +49,36 @@ export function SidebarCient({
const [currentlySelectedProjectId, setCurrentlySelectedProjectId] = useState
(null);
const [currentlySelectedAppId, setCurrentlySelectedAppId] = useState(null);
+ const settingsMenu = [
+ {
+ title: "Profile",
+ url: "/settings/profile",
+ icon: User,
+ },
+ {
+ title: "Users & Groups",
+ url: "/settings/users",
+ icon: User2,
+ adminOnly: true,
+ },
+ {
+ title: "S3 Targets",
+ url: "/settings/s3-targets",
+ icon: Settings,
+ adminOnly: true,
+ },
+ {
+ title: "Cluster",
+ url: "/settings/cluster",
+ adminOnly: true,
+ },
+ {
+ title: QuickStack Settings {newVersionInfo &&
} ,
+ url: "/settings/server",
+ adminOnly: true,
+ },
+ ]
+
useEffect(() => {
if (path.startsWith('/project/app/')) {
const appId = path.split('/')[3];
@@ -265,7 +267,7 @@ export function SidebarCient({
{(UserGroupUtils.isAdmin(session) ? settingsMenu :
settingsMenu.filter(x => !x.adminOnly)).map((item) => (
-
+
{item.title}
diff --git a/src/app/sidebar.tsx b/src/app/sidebar.tsx
index b33593dc..c58261a5 100644
--- a/src/app/sidebar.tsx
+++ b/src/app/sidebar.tsx
@@ -2,6 +2,7 @@ import projectService from "@/server/services/project.service"
import { getUserSession } from "@/server/utils/action-wrapper.utils"
import { SidebarCient } from "./sidebar-client"
import { UserGroupUtils } from "@/shared/utils/role.utils";
+import quickStackUpdateService from "@/server/services/qs-update.service";
export async function AppSidebar() {
@@ -12,12 +13,12 @@ export async function AppSidebar() {
}
const projects = await projectService.getAllProjects();
-
+ const newVersionInfo = await quickStackUpdateService.getNewVersionInfo();
const relevantProjectsForUser = projects.filter((project) =>
UserGroupUtils.sessionHasReadAccessToProject(session, project.id));
for (const project of relevantProjectsForUser) {
project.apps = project.apps.filter((app) => UserGroupUtils.sessionHasReadAccessForApp(session, app.id));
}
- return {
+ const response = await fetch(`${this.GITHUB_API_BASE_URL}/repos/biersoeckli/QuickStack/releases/latest`, {
+ cache: 'no-cache',
+ method: 'GET',
+ headers: {
+
+ 'Accept': 'application/json',
+ 'Content-Type': 'application/json'
+ }
+ });
+ if (!response.ok) {
+ throw new Error(`Failed to fetch latest QuickStack version from GitHub: HTTP ${response.status} ${response.statusText}`);
+ }
+ const data = await response.json();
+ return {
+ version: data.tag_name,
+ url: data.html_url,
+ publishedAt: data.published_at,
+ body: data.body
+ };
+ }
+
+ /* example:
+ {
+ "url": "https://api.github.com/repos/biersoeckli/QuickStack/releases/267434818",
+ "assets_url": "https://api.github.com/repos/biersoeckli/QuickStack/releases/267434818/assets",
+ "upload_url": "https://uploads.github.com/repos/biersoeckli/QuickStack/releases/267434818/assets{?name,label}",
+ "html_url": "https://github.com/biersoeckli/QuickStack/releases/tag/0.0.6",
+ "id": 267434818,
+ "author": {
+ "login": "biersoeckli",
+ "id": 24962453,
+ "node_id": "MDQ6VXNlcjI0OTYyNDUz",
+ "avatar_url": "https://avatars.githubusercontent.com/u/24962453?v=4",
+ "gravatar_id": "",
+ "url": "https://api.github.com/users/biersoeckli",
+ "html_url": "https://github.com/biersoeckli",
+ "followers_url": "https://api.github.com/users/biersoeckli/followers",
+ "following_url": "https://api.github.com/users/biersoeckli/following{/other_user}",
+ "gists_url": "https://api.github.com/users/biersoeckli/gists{/gist_id}",
+ "starred_url": "https://api.github.com/users/biersoeckli/starred{/owner}{/repo}",
+ "subscriptions_url": "https://api.github.com/users/biersoeckli/subscriptions",
+ "organizations_url": "https://api.github.com/users/biersoeckli/orgs",
+ "repos_url": "https://api.github.com/users/biersoeckli/repos",
+ "events_url": "https://api.github.com/users/biersoeckli/events{/privacy}",
+ "received_events_url": "https://api.github.com/users/biersoeckli/received_events",
+ "type": "User",
+ "user_view_type": "public",
+ "site_admin": false
+ },
+ "node_id": "RE_kwDONfVBr84P8LtC",
+ "tag_name": "0.0.6",
+ "target_commitish": "main",
+ "name": "0.0.6",
+ "draft": false,
+ "immutable": false,
+ "prerelease": false,
+ "created_at": "2025-12-04T13:33:14Z",
+ "updated_at": "2025-12-04T13:34:32Z",
+ "published_at": "2025-12-04T13:34:32Z",
+ "assets": [
+
+ ],
+ "tarball_url": "https://api.github.com/repos/biersoeckli/QuickStack/tarball/0.0.6",
+ "zipball_url": "https://api.github.com/repos/biersoeckli/QuickStack/zipball/0.0.6",
+ "body": "## What's Changed\r\n* fix: use sudo for kubectl commands in setup scripts to ensure proper permissions by @biersoeckli in https://github.com/biersoeckli/QuickStack/pull/42\r\n* Feat/replace traefikme dns service by @biersoeckli in https://github.com/biersoeckli/QuickStack/pull/48\r\n* feat/upgrade prisma orm to v7 by @biersoeckli in https://github.com/biersoeckli/QuickStack/pull/47\r\n\r\n\r\n**Full Changelog**: https://github.com/biersoeckli/QuickStack/compare/0.0.5...0.0.6",
+ "reactions": {
+ "url": "https://api.github.com/repos/biersoeckli/QuickStack/releases/267434818/reactions",
+ "total_count": 1,
+ "+1": 0,
+ "-1": 0,
+ "laugh": 0,
+ "hooray": 0,
+ "confused": 0,
+ "heart": 1,
+ "rocket": 0,
+ "eyes": 0
+ },
+ "mentions_count": 1
+}
+*/
+
+}
+
+
+export const githubAdapter = new GithubAdapter();
diff --git a/src/server/services/qs-update.service.ts b/src/server/services/qs-update.service.ts
new file mode 100644
index 00000000..84031bc0
--- /dev/null
+++ b/src/server/services/qs-update.service.ts
@@ -0,0 +1,35 @@
+import { unstable_cache } from "next/cache";
+import quickStackService from "./qs.service";
+import { githubAdapter } from "../adapter/github.adapter";
+import { Tags } from "../utils/cache-tag-generator.utils";
+
+class QuickStackUpdateService {
+
+ async getNewVersionInfo() {
+ try {
+ const currentVersion = quickStackService.getVersionOfCurrentQuickstackInstance();
+ if (!currentVersion) {
+ return undefined;
+ }
+
+ if (currentVersion.includes('canary')) {
+ return undefined;
+ }
+
+ const latestVersionInfo = await unstable_cache(async () => githubAdapter.getLatestQuickStackVersion(),
+ [Tags.quickStackVersionInfo()], {
+ tags: [Tags.quickStackVersionInfo()],
+ revalidate: 60 * 15, // 15 minutes
+ })();
+ if (currentVersion === latestVersionInfo.version) {
+ return undefined;
+ }
+ return latestVersionInfo;
+ } catch (error) {
+ console.error("Error fetching latest QuickStack version:", error);
+ }
+ }
+}
+
+const quickStackUpdateService = new QuickStackUpdateService();
+export default quickStackUpdateService;
\ No newline at end of file
diff --git a/src/server/services/qs.service.ts b/src/server/services/qs.service.ts
index 05b3b1ab..4d965155 100644
--- a/src/server/services/qs.service.ts
+++ b/src/server/services/qs.service.ts
@@ -15,7 +15,7 @@ class QuickStackService {
private readonly QUICKSTACK_SERVICEACCOUNT_NAME = 'qs-service-account';
private readonly CLUSTER_ISSUER_NAME = 'letsencrypt-production';
- async getVersionOfCurrentQuickstackInstance() {
+ getVersionOfCurrentQuickstackInstance() {
return process.env.QS_VERSION || undefined;
}
diff --git a/src/server/utils/cache-tag-generator.utils.ts b/src/server/utils/cache-tag-generator.utils.ts
index 5a55f910..85765a7b 100644
--- a/src/server/utils/cache-tag-generator.utils.ts
+++ b/src/server/utils/cache-tag-generator.utils.ts
@@ -39,4 +39,8 @@ export class Tags {
static nodeInfos() {
return `node-infos`;
}
+
+ static quickStackVersionInfo() {
+ return `quickstack-version-info`;
+ }
}
\ No newline at end of file