feat: add configurable backup file prefix

.env.example

@@ -73,6 +73,10 @@ AUTH_PASSKEY_ENABLED=true
 # Retention
 RETENTION_CRON="* * * * *"
 
+# Optional prefix for backup files stored in configured storage channels.
+# Defaults to "backups" when unset.
+#BACKUP_FILE_PREFIX=backups
+
 TRUSTED_DOMAINS="http://localhost:8887, http://localhost:3055, http://localhost:3056"
 
 #OPENAPI_ENABLED=true

src/env.mjs

@@ -5,6 +5,11 @@ import packageJson from "../package.json" with {type: "json"};
 
 const {version} = packageJson;
 
+export function getBackupFilePrefix() {
+    const separator = String.fromCharCode(47);
+    return env.BACKUP_FILE_PREFIX?.trim().split(separator).filter(Boolean).join(separator) || "backups";
+}
+
 export const env = createEnv({
     emptyStringAsUndefined: true,
     server: {
@@ -66,6 +71,8 @@ export const env = createEnv({
 
         STALE_BACKUP_THRESHOLD_HOURS: z.coerce.number().default(6),
 
+        BACKUP_FILE_PREFIX: z.string().optional(),
+
         AUTH_OIDC_ID: z.string().optional().default("oidc"),
         AUTH_OIDC_TITLE: z.string().optional(),
         AUTH_OIDC_DESC: z.string().optional(),
@@ -154,6 +161,7 @@ export const env = createEnv({
         RETENTION_CRON: process.env.RETENTION_CRON,
         CLEANING_HEALTHCHECK_LOGS_CRON: process.env.CLEANING_HEALTHCHECK_LOGS_CRON,
         STALE_BACKUP_THRESHOLD_HOURS: process.env.STALE_BACKUP_THRESHOLD_HOURS,
+        BACKUP_FILE_PREFIX: process.env.BACKUP_FILE_PREFIX,
 
         AUTH_OIDC_ID: process.env.AUTH_OIDC_ID,
         AUTH_OIDC_TITLE: process.env.AUTH_OIDC_TITLE,

src/features/agents/utils/status/storage-channels.helpers.ts

@@ -1,11 +1,13 @@
 import * as drizzleDb from "@/db";
 import {db} from "@/db";
 import {eq} from "drizzle-orm";
+import {getBackupFilePrefix} from "@/env";
 
 export type PingDatabaseStorageChannels = {
     id: string;
     config: any
     provider: string
+    prefix: string
 }
 
 export async function getDatabaseStorageChannels(databaseId: string): Promise<PingDatabaseStorageChannels[]> {
@@ -24,6 +26,8 @@ export async function getDatabaseStorageChannels(databaseId: string): Promise<Pi
         return []
     }
 
+    const prefix = getBackupFilePrefix();
+
     const settings = await db.query.setting.findFirst({
         where: eq(drizzleDb.schemas.setting.name, "system"),
         with: {storageChannel: true},
@@ -34,6 +38,7 @@ export async function getDatabaseStorageChannels(databaseId: string): Promise<Pi
             id: settings.storageChannel.id,
             provider: settings.storageChannel.provider,
             config: settings.storageChannel.config,
+            prefix,
         }]
         : [];
 
@@ -52,6 +57,7 @@ export async function getDatabaseStorageChannels(databaseId: string): Promise<Pi
                     id: storageChannel.id,
                     config: storageChannel.config,
                     provider: storageChannel.provider,
+                    prefix,
                 } as PingDatabaseStorageChannels;
             })
     );

src/features/storages/utils/storages.helpers.ts

@@ -14,6 +14,7 @@ import {db} from "@/db";
 import {createHash} from "crypto";
 import {getServerUrl} from "@/utils/get-server-url";
 import path from "path";
+import {getBackupFilePrefix} from "@/env";
 
 function computeChecksum(buffer: Buffer): string {
     return createHash("sha256").update(buffer).digest("hex");
@@ -55,7 +56,7 @@ export async function storeBackupFiles(
         return [];
     }
 
-    const path = `backups/${database.project?.slug}/${fileName}`;
+    const path = `${getBackupFilePrefix()}/${database.project?.slug}/${fileName}`;
     const size = file.length;
     const checksum = computeChecksum(file);