@nocobase/cli 2.1.0-alpha.40 → 2.1.0-alpha.46

package/dist/commands/install.js

@@ -7,27 +7,27 @@
  * For more information, please refer to: https://www.nocobase.com/agreement.
  */
 import { Command, Flags } from '@oclif/core';
-import { spawn } from 'node:child_process';
 import crypto from 'node:crypto';
-import { mkdir } from 'node:fs/promises';
+import { access, mkdir } from 'node:fs/promises';
 import path from 'node:path';
 import { exit } from 'node:process';
 import { runPromptCatalog, } from "../lib/prompt-catalog.js";
-import { applyCliLocale, localeText, resolveCliLocale, translateCli, } from "../lib/cli-locale.js";
+import { applyCliLocale, localeText, resolveCliLocale, translateCli } from "../lib/cli-locale.js";
 import { resolveConfiguredEnvPath, resolveDefaultConfigScope, resolveEnvRoot, resolveEnvRelativePath, } from '../lib/cli-home.js';
-import { defaultDockerContainerPrefix, defaultDockerNetworkName, } from '../lib/app-runtime.js';
-import { resolveDockerContainerPrefix, resolveDockerNetworkName, } from '../lib/cli-config.js';
-import { DEFAULT_DOCKER_VERSION, resolveDockerImageRef, } from "../lib/docker-image.js";
+import { defaultDockerContainerPrefix, defaultDockerNetworkName } from '../lib/app-runtime.js';
+import { resolveDockerContainerPrefix, resolveDockerNetworkName } from '../lib/cli-config.js';
+import { DEFAULT_DOCKER_VERSION, resolveDockerImageRef } from "../lib/docker-image.js";
 import { findAvailableTcpPort, validateAvailableTcpPort, validateTcpPort, validateEnvKey, } from "../lib/prompt-validators.js";
-import { validateExternalDbConfig } from "../lib/db-connection-check.js";
+import { validateExternalDbConfig, validateMysqlLowerCaseTableNamesCompatibility } from "../lib/db-connection-check.js";
 import { formatMissingManagedAppEnvMessage } from '../lib/app-runtime.js';
-import { run, runNocoBaseCommand } from '../lib/run-npm.js';
-import { printInfo, printStage, printVerbose, printWarning, setVerboseMode, } from '../lib/ui.js';
+import { commandOutput, commandSucceeds, run, runNocoBaseCommand } from '../lib/run-npm.js';
+import { printInfo, printStage, printVerbose, printWarning, setVerboseMode } from '../lib/ui.js';
 import { omitKeys, upperFirst } from "../lib/object-utils.js";
 import { getEnv, setCurrentEnv, upsertEnv } from '../lib/auth-store.js';
 import { buildStoredEnvConfig } from '../lib/env-config.js';
-import { resolveDockerEnvFileArg, } from "../lib/docker-env-file.js";
-import Download, { defaultDockerRegistryForLang, } from './download.js';
+import { resolveDockerEnvFileArg } from "../lib/docker-env-file.js";
+import { startDockerLogFollower } from '../lib/docker-log-stream.js';
+import Download, { defaultDockerRegistryForLang } from './download.js';
 import EnvAdd from "./env/add.js";
 const DEFAULT_INSTALL_ENV_NAME = 'local';
 const DEFAULT_INSTALL_LANG = 'en-US';
@@ -139,6 +139,9 @@ const installText = (key, values) => localeText(`commands.install.${key}`, value
 function formatDeferredAuthMessage(envName, authType) {
     const normalizedAuthType = String(authType ?? '').trim();
     const nextStep = `Authentication was skipped for env "${envName}". Run \`nb env auth ${envName}\` to finish setup.`;
+    if (normalizedAuthType === 'basic') {
+        return `${nextStep} You will be prompted for a username and password.`;
+    }
     if (normalizedAuthType === 'token') {
         return `${nextStep} You will be prompted for an access token.`;
     }
@@ -154,9 +157,7 @@ function isInstallDbDialect(value) {
     return INSTALL_DB_DIALECTS.includes(value);
 }
 function downloadVersionPromptValue(version) {
-    return version === 'latest' || version === 'beta' || version === 'alpha'
-        ? version
-        : 'other';
+    return version === 'latest' || version === 'beta' || version === 'alpha' ? version : 'other';
 }
 function supportsBuiltinDbDialect(value) {
     const dialect = String(value ?? '').trim();
@@ -171,22 +172,16 @@ function defaultBuiltinDbImageForDialect(value) {
     const defaults = resolveCliLocale(process.env.NB_LOCALE) === 'zh-CN'
         ? DEFAULT_INSTALL_BUILTIN_DB_IMAGES_ZH_CN
         : DEFAULT_INSTALL_BUILTIN_DB_IMAGES;
-    return supportsBuiltinDbDialect(dialect)
-        ? defaults[dialect]
-        : defaults.postgres;
+    return supportsBuiltinDbDialect(dialect) ? defaults[dialect] : defaults.postgres;
 }
 function defaultDbDatabaseForDialect(value) {
-    return String(value ?? '').trim() === 'kingbase'
-        ? 'kingbase'
-        : DEFAULT_INSTALL_DB_DATABASE;
+    return String(value ?? '').trim() === 'kingbase' ? 'kingbase' : DEFAULT_INSTALL_DB_DATABASE;
 }
 function defaultDbHostForBuiltinDb(values) {
-    return Boolean(values.builtinDb)
-        ? DEFAULT_INSTALL_BUILTIN_DB_HOST
-        : DEFAULT_INSTALL_DB_HOST;
+    return values.builtinDb ? DEFAULT_INSTALL_BUILTIN_DB_HOST : DEFAULT_INSTALL_DB_HOST;
 }
 function validateBuiltinDbEnabled(value, values) {
-    if (!Boolean(value)) {
+    if (!value) {
         return undefined;
     }
     const dialect = String(values.dbDialect ?? 'postgres').trim() || 'postgres';
@@ -203,7 +198,14 @@ async function validateExternalDbPromptField(value, values) {
     if (typeof value === 'string' && value.trim() === '') {
         return undefined;
     }
-    return await validateExternalDbConfig(values);
+    const connectionError = await validateExternalDbConfig(values);
+    if (connectionError) {
+        return connectionError;
+    }
+    if (!Object.prototype.hasOwnProperty.call(values, 'dbUnderscored')) {
+        return undefined;
+    }
+    return await validateMysqlLowerCaseTableNamesCompatibility(values);
 }
 function defaultInstallAppRootPath(envName) {
     const name = String(envName ?? DEFAULT_INSTALL_ENV_NAME).trim() || DEFAULT_INSTALL_ENV_NAME;
@@ -222,54 +224,6 @@ function pickPresetKeys(source, keys) {
     }
     return out;
 }
-async function commandSucceeds(command, args, options) {
-    return await new Promise((resolve) => {
-        const child = spawn(command, args, {
-            cwd: options?.cwd,
-            env: {
-                ...process.env,
-                ...options?.env,
-            },
-            stdio: 'ignore',
-        });
-        child.once('error', () => resolve(false));
-        child.once('close', (code) => resolve(code === 0));
-    });
-}
-async function commandOutput(command, args, options) {
-    return await new Promise((resolve, reject) => {
-        const child = spawn(command, args, {
-            cwd: options?.cwd,
-            env: {
-                ...process.env,
-                ...options?.env,
-            },
-            stdio: ['ignore', 'pipe', 'pipe'],
-        });
-        let stdout = '';
-        let stderr = '';
-        child.stdout.setEncoding('utf8');
-        child.stderr.setEncoding('utf8');
-        child.stdout.on('data', (chunk) => {
-            stdout += chunk;
-        });
-        child.stderr.on('data', (chunk) => {
-            stderr += chunk;
-        });
-        child.once('error', reject);
-        child.once('close', (code, signal) => {
-            if (code === 0) {
-                resolve(stdout);
-                return;
-            }
-            if (signal) {
-                reject(new Error(`${command} exited due to signal ${signal}`));
-                return;
-            }
-            reject(new Error(`${command} exited with code ${code}: ${stderr.trim()}`));
-        });
-    });
-}
 function optionalEnvString(value) {
     const text = String(value ?? '').trim();
     return text || undefined;
@@ -324,7 +278,7 @@ export default class Install extends Command {
         '<%= config.bin %> <%= command.id %> --env app1 --root-nickname "Super Admin"',
         '<%= config.bin %> <%= command.id %> --env myenv --app-root-path=./myenv/source/ --storage-path=./myenv/storage/',
         '<%= config.bin %> <%= command.id %> --env dev -y --app-root-path=./dev/source/',
-        '<%= config.bin %> <%= command.id %> --env dev -y --fetch-source --app-root-path=./dev/source/',
+        '<%= config.bin %> <%= command.id %> --env dev -y --skip-download --source git --app-root-path=./dev/source/',
     ];
     static flags = {
         yes: Flags.boolean({
@@ -359,14 +313,20 @@ export default class Install extends Command {
         }),
         'auth-type': Flags.string({
             char: 'a',
-            description: 'Authentication: token (API key) or oauth (browser login via `nb env auth`)',
-            options: ['token', 'oauth'],
+            description: 'Authentication: basic (username/password login), token (API key), or oauth (browser login via `nb env auth`)',
+            options: ['basic', 'token', 'oauth'],
         }),
         'access-token': Flags.string({
             char: 't',
             aliases: ['token'],
             description: 'API key or access token when using --auth-type token',
         }),
+        username: Flags.string({
+            description: 'Username when using --auth-type basic',
+        }),
+        password: Flags.string({
+            description: 'Password when using --auth-type basic',
+        }),
         'skip-auth': Flags.boolean({
             description: 'Save the env auth mode now and finish authentication later with `nb env auth`',
             default: false,
@@ -440,8 +400,8 @@ export default class Install extends Command {
             description: 'Use underscored database naming for the app',
             default: false,
         }),
-        'fetch-source': Flags.boolean({
-            description: 'Download NocoBase app files or pull a Docker image before installing',
+        'skip-download': Flags.boolean({
+            description: 'Skip the download step and reuse an existing local app directory or Docker image',
             default: false,
         }),
         ...omitKeys(Download.flags, ['yes']),
@@ -488,12 +448,6 @@ export default class Install extends Command {
             placeholder: installText('prompts.storagePath.placeholder'),
             initialValue: (values) => defaultInstallStoragePath(values.env ?? values.appName),
         },
-        fetchSource: {
-            type: 'boolean',
-            message: installText('prompts.fetchSource.message'),
-            initialValue: true,
-            yesInitialValue: true,
-        },
     };
     static dbPrompts = {
         dbDialect: {
@@ -521,8 +475,7 @@ export default class Install extends Command {
             message: installText('prompts.builtinDbImage.message'),
             placeholder: installText('prompts.builtinDbImage.placeholder'),
             initialValue: (values) => defaultBuiltinDbImageForDialect(values.dbDialect),
-            hidden: (values) => !Boolean(values.builtinDb)
-                || !supportsBuiltinDbDialect(values.dbDialect),
+            hidden: (values) => !values.builtinDb || !supportsBuiltinDbDialect(values.dbDialect),
             required: true,
         },
         dbHost: {
@@ -542,8 +495,7 @@ export default class Install extends Command {
             initialValue: (values) => defaultDbPortForDialect(values.dbDialect),
             required: true,
             validate: Install.validateDbPort,
-            hidden: (values) => Boolean(values.builtinDb)
-                && String(values.source ?? '').trim() === 'docker',
+            hidden: (values) => Boolean(values.builtinDb) && String(values.source ?? '').trim() === 'docker',
         },
         dbDatabase: {
             type: 'text',
@@ -568,6 +520,27 @@ export default class Install extends Command {
             required: true,
             validate: validateExternalDbPromptField,
         },
+        dbSchema: {
+            type: 'text',
+            message: installText('prompts.dbSchema.message'),
+            placeholder: installText('prompts.dbSchema.placeholder'),
+            hidden: (values) => String(values.dbDialect ?? '').trim() !== 'postgres',
+        },
+        dbTablePrefix: {
+            type: 'text',
+            message: installText('prompts.dbTablePrefix.message'),
+            placeholder: installText('prompts.dbTablePrefix.placeholder'),
+        },
+        dbUnderscored: {
+            type: 'boolean',
+            message: installText('prompts.dbUnderscored.message'),
+            initialValue: false,
+            yesInitialValue: false,
+            validate: (value, values) => validateExternalDbPromptField(value, {
+                ...values,
+                dbUnderscored: Boolean(value),
+            }),
+        },
     };
     static rootUserPrompts = {
         rootUsername: {
@@ -662,9 +635,8 @@ export default class Install extends Command {
      * Booleans with defaults are only preset when the user passed the flag on argv (see `download`).
      * Does not include `env` — use {@link buildEnvPresetValuesFromFlags} for {@link Install.envPrompts}.
      */
-    static buildPresetValuesFromFlags(flags) {
+    static buildPresetValuesFromFlags(flags, argv = process.argv.slice(2)) {
         const preset = {};
-        const argv = process.argv.slice(2);
         const apiBaseUrl = Install.toOptionalPromptString(flags['api-base-url']);
         if (apiBaseUrl) {
             preset.apiBaseUrl = apiBaseUrl;
@@ -687,6 +659,12 @@ export default class Install extends Command {
         if (flags['access-token'] !== undefined || flags.token !== undefined) {
             preset.accessToken = String(flags['access-token'] ?? flags.token ?? '');
         }
+        if (flags.username !== undefined) {
+            preset.username = String(flags.username ?? '').trim();
+        }
+        if (flags.password !== undefined) {
+            preset.password = String(flags.password ?? '');
+        }
         if (flags.lang !== undefined) {
             const v = String(flags.lang).trim();
             if (v) {
@@ -726,8 +704,15 @@ export default class Install extends Command {
         if (flags['root-nickname'] !== undefined) {
             preset.rootNickname = String(flags['root-nickname'] ?? '').trim();
         }
-        if (argvHasToken(argv, ['--fetch-source'])) {
-            preset.fetchSource = flags['fetch-source'];
+        if (argvHasToken(argv, ['--skip-download'])) {
+            preset.skipDownload = flags['skip-download'];
+            if (flags['skip-download']) {
+                preset.dockerSave = false;
+                preset.replace = false;
+                preset.devDependencies = false;
+                preset.build = false;
+                preset.buildDts = false;
+            }
         }
         if (argvHasToken(argv, ['--builtin-db', '--no-builtin-db'])) {
             preset.builtinDb = flags['builtin-db'];
@@ -789,18 +774,17 @@ export default class Install extends Command {
         }
         return preset;
     }
-    static buildAppPresetValuesFromFlags(flags) {
-        return pickPresetKeys(Install.buildPresetValuesFromFlags(flags), [
+    static buildAppPresetValuesFromFlags(flags, argv = process.argv.slice(2)) {
+        return pickPresetKeys(Install.buildPresetValuesFromFlags(flags, argv), [
             'lang',
             'force',
             'appRootPath',
             'appPort',
             'storagePath',
-            'fetchSource',
         ]);
     }
-    static buildDbPresetValuesFromFlags(flags) {
-        return pickPresetKeys(Install.buildPresetValuesFromFlags(flags), [
+    static buildDbPresetValuesFromFlags(flags, argv = process.argv.slice(2)) {
+        return pickPresetKeys(Install.buildPresetValuesFromFlags(flags, argv), [
             'builtinDb',
             'dbDialect',
             'builtinDbImage',
@@ -814,18 +798,20 @@ export default class Install extends Command {
             'dbUnderscored',
         ]);
     }
-    static buildRootPresetValuesFromFlags(flags) {
-        return pickPresetKeys(Install.buildPresetValuesFromFlags(flags), [
+    static buildRootPresetValuesFromFlags(flags, argv = process.argv.slice(2)) {
+        return pickPresetKeys(Install.buildPresetValuesFromFlags(flags, argv), [
             'rootUsername',
             'rootEmail',
             'rootPassword',
             'rootNickname',
         ]);
     }
-    static buildEnvAddPresetValuesFromFlags(flags) {
-        return pickPresetKeys(Install.buildPresetValuesFromFlags(flags), [
+    static buildEnvAddPresetValuesFromFlags(flags, argv = process.argv.slice(2)) {
+        return pickPresetKeys(Install.buildPresetValuesFromFlags(flags, argv), [
             'apiBaseUrl',
             'authType',
+            'username',
+            'password',
             'accessToken',
         ]);
     }
@@ -857,6 +843,18 @@ export default class Install extends Command {
         const text = String(value).trim();
         return text || undefined;
     }
+    static resolveManagedAppKey(value) {
+        return Install.toOptionalPromptString(value) ?? crypto.randomBytes(32).toString('hex');
+    }
+    static resolveManagedTimeZone(value) {
+        return Install.toOptionalPromptString(value) ?? (Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC');
+    }
+    async ensureManagedAppRuntimeConfig(params) {
+        const savedEnv = await getEnv(params.envName, { scope: resolveDefaultConfigScope() });
+        const savedConfig = savedEnv?.config;
+        params.appResults.appKey = Install.resolveManagedAppKey(params.appResults.appKey ?? savedConfig?.appKey);
+        params.appResults.timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone ?? savedConfig?.timezone);
+    }
     static async validateAppPort(value, values) {
         const formatError = validateTcpPort(value);
         if (formatError) {
@@ -915,9 +913,13 @@ export default class Install extends Command {
         if (validationError) {
             throw new Error(validationError);
         }
+        const compatibilityError = await validateMysqlLowerCaseTableNamesCompatibility(dbResults);
+        if (compatibilityError) {
+            throw new Error(compatibilityError);
+        }
     }
     static async readResumePortValidationContext(values) {
-        if (!Boolean(values.resume)) {
+        if (!values.resume) {
             return undefined;
         }
         const envName = Install.toOptionalPromptString(values.env);
@@ -948,8 +950,7 @@ export default class Install extends Command {
     }
     static async isResumeManagedPortReuse(params) {
         if (params.target === 'app') {
-            if ((params.context.source === 'npm' || params.context.source === 'git')
-                && params.context.appRootPath) {
+            if ((params.context.source === 'npm' || params.context.source === 'git') && params.context.appRootPath) {
                 return await Install.isLocalPm2ProcessUsingPort(params.context.appRootPath, params.port);
             }
             const containerName = Install.buildDockerAppContainerName(params.context.envName, params.context.dockerContainerPrefix);
@@ -965,19 +966,13 @@ export default class Install extends Command {
         if (!containerName || !port) {
             return false;
         }
-        const exists = await commandSucceeds('docker', [
-            'container',
-            'inspect',
-            containerName,
-        ]);
+        const exists = await commandSucceeds('docker', ['container', 'inspect', containerName]);
         if (!exists) {
             return false;
         }
         try {
             const output = await commandOutput('docker', ['port', containerName]);
-            return output
-                .split(/\r?\n/)
-                .some((line) => line.includes(`:${port}`));
+            return output.split(/\r?\n/).some((line) => line.includes(`:${port}`));
         }
         catch {
             return false;
@@ -1033,29 +1028,20 @@ export default class Install extends Command {
             ...(appRootPath ? { appRootPath } : {}),
             ...(appPort ? { appPort } : {}),
             ...(storagePath ? { storagePath } : {}),
-            ...(source
-                ? { fetchSource: true }
-                : appRootPath
-                    ? { fetchSource: false }
-                    : {}),
         };
         const downloadPreset = {
             ...(source ? { source } : {}),
             ...(downloadVersion
                 ? {
                     version: downloadVersionPromptValue(downloadVersion),
-                    ...(downloadVersionPromptValue(downloadVersion) === 'other'
-                        ? { otherVersion: downloadVersion }
-                        : {}),
+                    ...(downloadVersionPromptValue(downloadVersion) === 'other' ? { otherVersion: downloadVersion } : {}),
                 }
                 : {}),
             ...(dockerRegistry ? { dockerRegistry } : {}),
             ...(dockerPlatform ? { dockerPlatform } : {}),
             ...(gitUrl ? { gitUrl } : {}),
             ...(npmRegistry ? { npmRegistry } : {}),
-            ...(typeof config.devDependencies === 'boolean'
-                ? { devDependencies: config.devDependencies }
-                : {}),
+            ...(typeof config.devDependencies === 'boolean' ? { devDependencies: config.devDependencies } : {}),
             ...(typeof config.build === 'boolean' ? { build: config.build } : {}),
             ...(typeof config.buildDts === 'boolean' ? { buildDts: config.buildDts } : {}),
         };
@@ -1085,6 +1071,13 @@ export default class Install extends Command {
                 envAddPreset.accessToken = String(auth.accessToken);
             }
         }
+        else if (savedAuthType === 'basic') {
+            envAddPreset.authType = 'basic';
+            const authUsername = Install.toOptionalPromptString(config.authUsername) ?? rootUsername;
+            if (authUsername) {
+                envAddPreset.username = authUsername;
+            }
+        }
         else if (savedAuthType === 'oauth') {
             envAddPreset.authType = 'oauth';
         }
@@ -1132,7 +1125,7 @@ export default class Install extends Command {
                 throw new Error([
                     `Cannot continue setup for "${env.name}" in non-interactive resume mode yet.`,
                     `These setup-only flags are not saved in the env config: ${missingFlags.join(', ')}`,
-                    `Run \`nb init --env ${env.name} --resume\` without \`--yes\`, or pass those flags again.`,
+                    `Run \`nb init --ui --env ${env.name} --resume\` without \`--yes\`, or pass those flags again.`,
                 ].join('\n'));
             }
         }
@@ -1169,8 +1162,7 @@ export default class Install extends Command {
     }
     static shouldPublishBuiltinDbPortForValues(values) {
         const builtinDb = values.builtinDb === undefined ? true : Boolean(values.builtinDb);
-        return builtinDb
-            && Install.shouldPublishBuiltinDbPort(values.source);
+        return builtinDb && Install.shouldPublishBuiltinDbPort(values.source);
     }
     static async buildDbPromptInitialValues(params) {
         if (params.flags['db-port'] !== undefined) {
@@ -1226,9 +1218,8 @@ export default class Install extends Command {
      * Resolve the effective preset `values` for the embedded download step.
      * Explicit download flags win; otherwise `-y` falls back to the docker + alpha quickstart path.
      */
-    static buildDownloadPresetValuesForInstall(flags, appResults, envName, yes) {
+    static buildDownloadPresetValuesForInstall(flags, appResults, envName, yes, argv = process.argv.slice(2)) {
         const preset = {};
-        const argv = process.argv.slice(2);
         const appRoot = String(appResults.appRootPath ?? '').trim() || defaultInstallAppRootPath(envName);
         const lang = String(appResults.lang ?? DEFAULT_INSTALL_LANG).trim() || DEFAULT_INSTALL_LANG;
         preset.lang = lang;
@@ -1267,8 +1258,7 @@ export default class Install extends Command {
             }
         }
         if (flags['npm-registry'] !== undefined) {
-            preset.npmRegistry =
-                typeof flags['npm-registry'] === 'string' ? flags['npm-registry'] : '';
+            preset.npmRegistry = typeof flags['npm-registry'] === 'string' ? flags['npm-registry'] : '';
         }
         if (flags.resume && !argvHasToken(argv, ['--replace', '-r'])) {
             preset.replace = true;
@@ -1312,15 +1302,11 @@ export default class Install extends Command {
     }
     static buildBuiltinDbContainerPrefix(containerPrefix) {
         const storedName = String(containerPrefix ?? '').trim();
-        return storedName
-            ? Install.sanitizeDockerResourceName(storedName)
-            : Install.defaultDockerContainerPrefix();
+        return storedName ? Install.sanitizeDockerResourceName(storedName) : Install.defaultDockerContainerPrefix();
     }
     static buildManagedDockerNetworkName(networkName) {
         const storedName = String(networkName ?? '').trim();
-        return storedName
-            ? Install.sanitizeDockerResourceName(storedName)
-            : Install.defaultDockerNetworkName();
+        return storedName ? Install.sanitizeDockerResourceName(storedName) : Install.defaultDockerNetworkName();
     }
     static buildBuiltinDbNetworkName(envName, networkName) {
         void envName;
@@ -1353,25 +1339,19 @@ export default class Install extends Command {
     }
     static buildBuiltinDbPlan(params) {
         const dbDialect = String(params.dbDialect ?? 'postgres').trim() || 'postgres';
-        const dbPort = String(params.dbPort ?? defaultDbPortForDialect(dbDialect)).trim()
-            || defaultDbPortForDialect(dbDialect);
+        const dbPort = String(params.dbPort ?? defaultDbPortForDialect(dbDialect)).trim() || defaultDbPortForDialect(dbDialect);
         const defaultDbDatabase = defaultDbDatabaseForDialect(dbDialect);
         const networkName = Install.buildBuiltinDbNetworkName(params.envName, params.dockerNetworkName ?? params.workspaceName);
         const containerName = Install.buildBuiltinDbContainerName(params.envName, dbDialect, params.dockerContainerPrefix ?? params.workspaceName);
         const dbHostInput = String(params.dbHost ?? '').trim();
         const dbHost = Install.shouldPublishBuiltinDbPort(params.source)
-            ? (dbHostInput
-                && dbHostInput !== DEFAULT_INSTALL_BUILTIN_DB_HOST
-                && dbHostInput !== containerName
+            ? dbHostInput && dbHostInput !== DEFAULT_INSTALL_BUILTIN_DB_HOST && dbHostInput !== containerName
                 ? dbHostInput
-                : DEFAULT_INSTALL_DB_HOST)
-            : (dbHostInput
-                && dbHostInput !== DEFAULT_INSTALL_DB_HOST
-                && dbHostInput !== 'localhost'
+                : DEFAULT_INSTALL_DB_HOST
+            : dbHostInput && dbHostInput !== DEFAULT_INSTALL_DB_HOST && dbHostInput !== 'localhost'
                 ? dbHostInput
-                : containerName);
-        const storagePath = resolveConfiguredEnvPath(params.storagePath)
-            ?? resolveEnvRelativePath(defaultInstallStoragePath(params.envName));
+                : containerName;
+        const storagePath = resolveConfiguredEnvPath(params.storagePath) ?? resolveEnvRelativePath(defaultInstallStoragePath(params.envName));
         if (dbDialect === 'postgres') {
             const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
             const dataDir = path.resolve(storagePath, 'db', 'postgres');
@@ -1402,12 +1382,9 @@ export default class Install extends Command {
                 dbDialect,
                 dbHost,
                 dbPort,
-                dbDatabase: String(params.dbDatabase ?? defaultDbDatabase).trim()
-                    || defaultDbDatabase,
-                dbUser: String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim()
-                    || DEFAULT_INSTALL_DB_USER,
-                dbPassword: String(params.dbPassword ?? DEFAULT_INSTALL_DB_PASSWORD)
-                    || DEFAULT_INSTALL_DB_PASSWORD,
+                dbDatabase: String(params.dbDatabase ?? defaultDbDatabase).trim() || defaultDbDatabase,
+                dbUser: String(params.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER,
+                dbPassword: String(params.dbPassword ?? DEFAULT_INSTALL_DB_PASSWORD) || DEFAULT_INSTALL_DB_PASSWORD,
                 networkName,
                 containerName,
                 dataDir,
@@ -1593,11 +1570,7 @@ export default class Install extends Command {
         }
     }
     async dockerContainerExists(name) {
-        return await commandSucceeds('docker', [
-            'container',
-            'inspect',
-            name,
-        ]);
+        return await commandSucceeds('docker', ['container', 'inspect', name]);
     }
     async removeDockerContainer(name) {
         await run('docker', ['rm', '-f', name], {
@@ -1647,8 +1620,7 @@ export default class Install extends Command {
         });
     }
     async startBuiltinDb(params) {
-        const storagePath = String(params.appResults.storagePath ?? '').trim()
-            || defaultInstallStoragePath(params.envName);
+        const storagePath = String(params.appResults.storagePath ?? '').trim() || defaultInstallStoragePath(params.envName);
         const plan = Install.buildBuiltinDbPlan({
             envName: params.envName,
             workspaceName: params.workspaceName,
@@ -1686,30 +1658,27 @@ export default class Install extends Command {
         return plan;
     }
     static async buildDockerAppPlan(params) {
-        const dockerRegistry = String(downloadResultsValue(params.downloadResults, 'dockerRegistry') ?? '').trim()
-            || defaultDockerRegistryForLang(process.env.NB_LOCALE);
+        const dockerRegistry = String(downloadResultsValue(params.downloadResults, 'dockerRegistry') ?? '').trim() ||
+            defaultDockerRegistryForLang(process.env.NB_LOCALE);
         const version = String(downloadResultsValue(params.downloadResults, 'version') ?? '').trim() || DEFAULT_DOCKER_VERSION;
         const imageRef = resolveDockerImageRef(dockerRegistry, version, {
             defaultRegistry: defaultDockerRegistryForLang(process.env.NB_LOCALE),
             defaultVersion: DEFAULT_DOCKER_VERSION,
         });
         const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
-        const storagePath = resolveConfiguredEnvPath(String(params.appResults.storagePath ?? '').trim()
-            || defaultInstallStoragePath(params.envName))
-            ?? resolveEnvRelativePath(defaultInstallStoragePath(params.envName));
+        const storagePath = resolveConfiguredEnvPath(String(params.appResults.storagePath ?? '').trim() || defaultInstallStoragePath(params.envName)) ?? resolveEnvRelativePath(defaultInstallStoragePath(params.envName));
         const dbDialect = String(params.dbResults.dbDialect ?? 'postgres').trim() || 'postgres';
         const dbHost = String(params.dbResults.dbHost ?? DEFAULT_INSTALL_DB_HOST).trim() || DEFAULT_INSTALL_DB_HOST;
-        const dbPort = String(params.dbResults.dbPort ?? defaultDbPortForDialect(dbDialect)).trim()
-            || defaultDbPortForDialect(dbDialect);
-        const dbDatabase = String(params.dbResults.dbDatabase ?? DEFAULT_INSTALL_DB_DATABASE).trim()
-            || DEFAULT_INSTALL_DB_DATABASE;
+        const dbPort = String(params.dbResults.dbPort ?? defaultDbPortForDialect(dbDialect)).trim() ||
+            defaultDbPortForDialect(dbDialect);
+        const dbDatabase = String(params.dbResults.dbDatabase ?? DEFAULT_INSTALL_DB_DATABASE).trim() || DEFAULT_INSTALL_DB_DATABASE;
         const dbUser = String(params.dbResults.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER;
         const dbPassword = String(params.dbResults.dbPassword ?? DEFAULT_INSTALL_DB_PASSWORD) || DEFAULT_INSTALL_DB_PASSWORD;
         const dbSchema = optionalEnvString(params.dbResults.dbSchema);
         const dbTablePrefix = optionalEnvString(params.dbResults.dbTablePrefix);
         const dbUnderscored = optionalEnvBoolean(params.dbResults.dbUnderscored);
-        const appKey = crypto.randomBytes(32).toString('hex');
-        const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+        const appKey = Install.resolveManagedAppKey(params.appResults.appKey);
+        const timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone);
         const containerName = Install.buildDockerAppContainerName(params.envName, params.dockerContainerPrefix ?? params.workspaceName);
         const configuredEnvFile = String(params.appResults.envFile ?? '').trim();
         const envFile = await resolveDockerEnvFileArg(params.envName, configuredEnvFile ? { envFile: configuredEnvFile } : undefined);
@@ -1767,8 +1736,8 @@ export default class Install extends Command {
         return 'created';
     }
     async installDockerApp(params) {
-        const networkName = params.builtinDbPlan?.networkName
-            ?? Install.buildBuiltinDbNetworkName(params.envName, params.dockerNetworkName ?? params.workspaceName);
+        const networkName = params.builtinDbPlan?.networkName ??
+            Install.buildBuiltinDbNetworkName(params.envName, params.dockerNetworkName ?? params.workspaceName);
         await this.ensureDockerNetwork(networkName);
         const plan = await Install.buildDockerAppPlan({
             envName: params.envName,
@@ -1815,26 +1784,26 @@ export default class Install extends Command {
         Install.pushDownloadArgIfValue(argv, '--source', results.source);
         Install.pushDownloadArgIfValue(argv, '--version', downloadResultsValue(results, 'version'));
         Install.pushDownloadArgIfValue(argv, '--output-dir', source === 'npm' || source === 'git'
-            ? (resolveConfiguredEnvPath(results.outputDir)
-                ?? resolveConfiguredEnvPath(String(results.outputDir ?? '').trim() || defaultInstallAppRootPath(results.env)))
+            ? resolveConfiguredEnvPath(results.outputDir) ??
+                resolveConfiguredEnvPath(String(results.outputDir ?? '').trim() || defaultInstallAppRootPath(results.env))
             : results.outputDir);
         Install.pushDownloadArgIfValue(argv, '--git-url', results.gitUrl);
         Install.pushDownloadArgIfValue(argv, '--docker-registry', results.dockerRegistry);
         Install.pushDownloadArgIfValue(argv, '--docker-platform', results.dockerPlatform);
         Install.pushDownloadArgIfValue(argv, '--npm-registry', results.npmRegistry);
-        if (Boolean(results.replace)) {
+        if (results.replace) {
             argv.push('--replace');
         }
-        if (Boolean(results.devDependencies)) {
+        if (results.devDependencies) {
             argv.push('--dev-dependencies');
         }
-        if (Boolean(results.dockerSave)) {
+        if (results.dockerSave) {
             argv.push('--docker-save');
         }
-        if (results.build !== undefined && !Boolean(results.build)) {
+        if (results.build !== undefined && !results.build) {
             argv.push('--no-build');
         }
-        if (Boolean(results.buildDts)) {
+        if (results.buildDts) {
             argv.push('--build-dts');
         }
         return argv;
@@ -1844,15 +1813,26 @@ export default class Install extends Command {
         if (projectRoot) {
             return projectRoot;
         }
-        const outputDir = String(params.downloadResults.outputDir ?? '').trim()
-            || String(params.appResults.appRootPath ?? '').trim()
-            || defaultInstallAppRootPath(params.envName);
+        const outputDir = String(params.downloadResults.outputDir ?? '').trim() ||
+            String(params.appResults.appRootPath ?? '').trim() ||
+            defaultInstallAppRootPath(params.envName);
         return resolveConfiguredEnvPath(outputDir) ?? resolveEnvRelativePath(defaultInstallAppRootPath(params.envName));
     }
     static resolveLocalProjectConfigPath(params) {
-        return (String(params.downloadResults.outputDir ?? '').trim()
-            || String(params.appResults.appRootPath ?? '').trim()
-            || defaultInstallAppRootPath(params.envName));
+        return (String(params.downloadResults.outputDir ?? '').trim() ||
+            String(params.appResults.appRootPath ?? '').trim() ||
+            defaultInstallAppRootPath(params.envName));
+    }
+    static buildSkipDownloadValues(envName, appResults) {
+        const appRoot = String(appResults.appRootPath ?? '').trim() || defaultInstallAppRootPath(envName);
+        return {
+            outputDir: appRoot,
+            replace: false,
+            dockerSave: false,
+            devDependencies: false,
+            build: false,
+            buildDts: false,
+        };
     }
     commandStdio(verbose) {
         return verbose ? 'inherit' : 'ignore';
@@ -1862,7 +1842,41 @@ export default class Install extends Command {
             verbose: params.verbose,
             compactLog: true,
         });
-        return await this.config.runCommand('source:download', argv);
+        return (await this.config.runCommand('source:download', argv));
+    }
+    async ensureSkippedDownloadInputsReady(params) {
+        if (params.source === 'docker') {
+            const dockerRegistry = String(downloadResultsValue(params.downloadResults, 'dockerRegistry') ?? '').trim() ||
+                defaultDockerRegistryForLang(process.env.NB_LOCALE);
+            const version = String(downloadResultsValue(params.downloadResults, 'version') ?? '').trim() || DEFAULT_DOCKER_VERSION;
+            const imageRef = resolveDockerImageRef(dockerRegistry, version, {
+                defaultRegistry: defaultDockerRegistryForLang(process.env.NB_LOCALE),
+                defaultVersion: DEFAULT_DOCKER_VERSION,
+            });
+            const imageExists = await commandSucceeds('docker', ['image', 'inspect', imageRef]);
+            if (!imageExists) {
+                throw new Error(translateCli('commands.install.messages.skipDownloadDockerImageMissing', {
+                    imageRef,
+                }));
+            }
+            return;
+        }
+        if (params.source === 'npm' || params.source === 'git') {
+            const projectRoot = Install.resolveLocalProjectRoot({
+                envName: params.envName,
+                appResults: params.appResults,
+                downloadResults: params.downloadResults,
+            });
+            try {
+                await access(projectRoot);
+                await access(path.join(projectRoot, 'package.json'));
+            }
+            catch {
+                throw new Error(translateCli('commands.install.messages.skipDownloadLocalAppMissing', {
+                    projectRoot,
+                }));
+            }
+        }
     }
     async downloadLocalApp(params) {
         const result = await this.downloadManagedSource({
@@ -1883,31 +1897,24 @@ export default class Install extends Command {
         return downloadedProjectRoot;
     }
     static buildLocalAppEnvVars(params) {
-        const configuredStoragePath = String(params.appResults.storagePath ?? '').trim()
-            || defaultInstallStoragePath(params.envName);
-        const storagePath = resolveConfiguredEnvPath(configuredStoragePath)
-            ?? resolveEnvRelativePath(defaultInstallStoragePath(params.envName));
-        const dbDialect = String(params.dbResults.dbDialect ?? 'postgres').trim()
-            || 'postgres';
-        const appKey = crypto.randomBytes(32).toString('hex');
-        const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+        const configuredStoragePath = String(params.appResults.storagePath ?? '').trim() || defaultInstallStoragePath(params.envName);
+        const storagePath = resolveConfiguredEnvPath(configuredStoragePath) ??
+            resolveEnvRelativePath(defaultInstallStoragePath(params.envName));
+        const dbDialect = String(params.dbResults.dbDialect ?? 'postgres').trim() || 'postgres';
+        const appKey = Install.resolveManagedAppKey(params.appResults.appKey);
+        const timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone);
         const env = {
             STORAGE_PATH: storagePath,
-            APP_PORT: String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim()
-                || DEFAULT_INSTALL_APP_PORT,
+            APP_PORT: String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT,
             APP_KEY: appKey,
             TZ: timeZone,
             DB_DIALECT: dbDialect,
-            DB_HOST: String(params.dbResults.dbHost ?? DEFAULT_INSTALL_DB_HOST).trim()
-                || DEFAULT_INSTALL_DB_HOST,
-            DB_PORT: String(params.dbResults.dbPort ?? defaultDbPortForDialect(dbDialect)).trim()
-                || defaultDbPortForDialect(dbDialect),
-            DB_DATABASE: String(params.dbResults.dbDatabase ?? DEFAULT_INSTALL_DB_DATABASE).trim()
-                || DEFAULT_INSTALL_DB_DATABASE,
-            DB_USER: String(params.dbResults.dbUser ?? DEFAULT_INSTALL_DB_USER).trim()
-                || DEFAULT_INSTALL_DB_USER,
-            DB_PASSWORD: String(params.dbResults.dbPassword ?? DEFAULT_INSTALL_DB_PASSWORD)
-                || DEFAULT_INSTALL_DB_PASSWORD,
+            DB_HOST: String(params.dbResults.dbHost ?? DEFAULT_INSTALL_DB_HOST).trim() || DEFAULT_INSTALL_DB_HOST,
+            DB_PORT: String(params.dbResults.dbPort ?? defaultDbPortForDialect(dbDialect)).trim() ||
+                defaultDbPortForDialect(dbDialect),
+            DB_DATABASE: String(params.dbResults.dbDatabase ?? DEFAULT_INSTALL_DB_DATABASE).trim() || DEFAULT_INSTALL_DB_DATABASE,
+            DB_USER: String(params.dbResults.dbUser ?? DEFAULT_INSTALL_DB_USER).trim() || DEFAULT_INSTALL_DB_USER,
+            DB_PASSWORD: String(params.dbResults.dbPassword ?? DEFAULT_INSTALL_DB_PASSWORD) || DEFAULT_INSTALL_DB_PASSWORD,
             ...Install.buildInitAppEnvVars({
                 appResults: params.appResults,
                 rootResults: params.rootResults,
@@ -1957,10 +1964,8 @@ export default class Install extends Command {
         };
     }
     static resolveApiBaseUrl(params) {
-        const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim()
-            || DEFAULT_INSTALL_APP_PORT;
-        return (String(params.envAddResults.apiBaseUrl ?? '').trim()
-            || `http://127.0.0.1:${appPort}/api`);
+        const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
+        return String(params.envAddResults.apiBaseUrl ?? '').trim() || `http://127.0.0.1:${appPort}/api`;
     }
     static buildHealthCheckUrl(apiBaseUrl) {
         return `${apiBaseUrl.replace(/\/+$/, '')}/__health_check`;
@@ -1989,9 +1994,7 @@ export default class Install extends Command {
             const body = Install.formatHealthCheckMessage(text);
             return {
                 ok: response.ok && text.trim().toLowerCase() === 'ok',
-                message: response.ok
-                    ? `HTTP ${response.status}: ${body}`
-                    : `HTTP ${response.status}: ${body}`,
+                message: response.ok ? `HTTP ${response.status}: ${body}` : `HTTP ${response.status}: ${body}`,
             };
         }
         catch (error) {
@@ -2020,32 +2023,38 @@ export default class Install extends Command {
         let lastMessage = 'No response yet';
         let lastLoggedStatus = '';
         printInfo('Waiting for NocoBase to become ready...');
-        while (Date.now() - startedAt < timeoutMs) {
-            const result = await Install.requestAppHealthCheck({
-                healthCheckUrl,
-                fetchImpl,
-                requestTimeoutMs,
-            });
-            if (result.ok) {
-                return;
-            }
-            lastMessage = result.message;
-            const elapsedSeconds = Math.max(1, Math.floor((Date.now() - startedAt) / 1000));
-            const statusLine = `Waiting for NocoBase to become ready... (${elapsedSeconds}s elapsed, last status: ${Install.formatHealthCheckMessage(lastMessage)})`;
-            if (statusLine !== lastLoggedStatus) {
-                printInfo(statusLine);
-                lastLoggedStatus = statusLine;
-            }
-            const remainingMs = timeoutMs - (Date.now() - startedAt);
-            if (remainingMs <= 0) {
-                break;
+        const dockerLogFollower = options?.verbose && options.containerName ? startDockerLogFollower(options.containerName) : undefined;
+        try {
+            while (Date.now() - startedAt < timeoutMs) {
+                const result = await Install.requestAppHealthCheck({
+                    healthCheckUrl,
+                    fetchImpl,
+                    requestTimeoutMs,
+                });
+                if (result.ok) {
+                    return;
+                }
+                lastMessage = result.message;
+                const elapsedSeconds = Math.max(1, Math.floor((Date.now() - startedAt) / 1000));
+                const statusLine = `Waiting for NocoBase to become ready... (${elapsedSeconds}s elapsed, last status: ${Install.formatHealthCheckMessage(lastMessage)})`;
+                if (statusLine !== lastLoggedStatus) {
+                    printInfo(statusLine);
+                    lastLoggedStatus = statusLine;
+                }
+                const remainingMs = timeoutMs - (Date.now() - startedAt);
+                if (remainingMs <= 0) {
+                    break;
+                }
+                await Install.sleep(Math.min(intervalMs, remainingMs));
             }
-            await Install.sleep(Math.min(intervalMs, remainingMs));
+            const logHint = options?.containerName
+                ? ` You can inspect startup logs with: docker logs ${options.containerName}`
+                : '';
+            throw new Error(`The application did not become ready in time. Expected \`${healthCheckUrl}\` to respond with \`ok\`, but the last status was: ${Install.formatHealthCheckMessage(lastMessage)}.${logHint}`);
+        }
+        finally {
+            await dockerLogFollower?.stop();
         }
-        const logHint = options?.containerName
-            ? ` You can inspect startup logs with: docker logs ${options.containerName}`
-            : '';
-        throw new Error(`The application did not become ready in time. Expected \`${healthCheckUrl}\` to respond with \`ok\`, but the last status was: ${Install.formatHealthCheckMessage(lastMessage)}.${logHint}`);
     }
     async saveInstalledEnv(params) {
         await upsertEnv(params.envName, Install.buildSavedEnvConfig(params), { scope: resolveDefaultConfigScope() });
@@ -2055,8 +2064,7 @@ export default class Install extends Command {
         if (!params.appReady) {
             return;
         }
-        const authType = String(params.envAddResults.authType ?? 'oauth').trim()
-            || 'oauth';
+        const authType = String(params.envAddResults.authType ?? 'oauth').trim() || 'oauth';
         if (params.skipAuth) {
             printInfo(formatDeferredAuthMessage(params.envName, authType));
             return;
@@ -2064,23 +2072,34 @@ export default class Install extends Command {
         if (authType === 'oauth') {
             await this.config.runCommand('env:auth', [params.envName]);
         }
+        else if (authType === 'basic') {
+            const authArgv = [params.envName, '--auth-type', 'basic'];
+            const username = String(params.envAddResults.username ?? '').trim();
+            const password = String(params.envAddResults.password ?? '');
+            if (username) {
+                authArgv.push('--username', username);
+            }
+            if (password) {
+                authArgv.push('--password', password);
+            }
+            await this.config.runCommand('env:auth', authArgv);
+        }
         await this.config.runCommand('env:update', [params.envName]);
     }
     static buildSavedEnvConfig(params) {
-        const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim()
-            || DEFAULT_INSTALL_APP_PORT;
-        const storagePath = String(params.appResults.storagePath ?? '').trim()
-            || defaultInstallStoragePath(params.envName);
+        const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
+        const storagePath = String(params.appResults.storagePath ?? '').trim() || defaultInstallStoragePath(params.envName);
         const envFile = String(params.appResults.envFile ?? '').trim() || undefined;
         const apiBaseUrl = Install.resolveApiBaseUrl({
             appResults: params.appResults,
             envAddResults: params.envAddResults,
         });
-        const authType = String(params.envAddResults.authType ?? 'oauth').trim()
-            || 'oauth';
+        const authType = String(params.envAddResults.authType ?? 'oauth').trim() || 'oauth';
+        const authUsername = authType === 'basic' ? String(params.envAddResults.username ?? params.rootResults.rootUsername ?? '').trim() : '';
         return buildStoredEnvConfig({
             apiBaseUrl,
             authType,
+            ...(authUsername ? { authUsername } : {}),
             accessToken: params.envAddResults.accessToken,
             source: downloadResultsValue(params.downloadResults, 'source'),
             downloadVersion: downloadResultsValue(params.downloadResults, 'version'),
@@ -2115,6 +2134,7 @@ export default class Install extends Command {
         });
     }
     async collectPromptResults(parsed, yes) {
+        const commandArgv = this.argv ?? process.argv.slice(2);
         const resumePreset = await this.resolveResumePresetValues(parsed, yes);
         const envPreset = {
             ...(resumePreset?.envPreset ?? {}),
@@ -2130,7 +2150,7 @@ export default class Install extends Command {
         const envName = String(envResults.env ?? '').trim() || DEFAULT_INSTALL_ENV_NAME;
         const appPreset = {
             ...(resumePreset?.appPreset ?? {}),
-            ...Install.buildAppPresetValuesFromFlags(parsed),
+            ...Install.buildAppPresetValuesFromFlags(parsed, commandArgv),
         };
         const appCatalog = Install.buildAppPromptsCatalog(envName, {
             resume: parsed.resume,
@@ -2140,56 +2160,58 @@ export default class Install extends Command {
                 envName,
                 flags: {
                     ...parsed,
-                    'app-root-path': parsed['app-root-path']
-                        ?? Install.toOptionalPromptString(appPreset.appRootPath),
-                    'app-port': parsed['app-port']
-                        ?? Install.toOptionalPromptString(appPreset.appPort),
-                    'storage-path': parsed['storage-path']
-                        ?? Install.toOptionalPromptString(appPreset.storagePath),
+                    'app-root-path': parsed['app-root-path'] ?? Install.toOptionalPromptString(appPreset.appRootPath),
+                    'app-port': parsed['app-port'] ?? Install.toOptionalPromptString(appPreset.appPort),
+                    'storage-path': parsed['storage-path'] ?? Install.toOptionalPromptString(appPreset.storagePath),
                 },
             }),
             values: appPreset,
             yesInitialValues: { resume: parsed.resume },
             yes,
         });
-        let downloadResults = {};
-        if (Boolean(appResults.fetchSource)) {
-            const downloadOpts = Install.buildDownloadPromptOptionsForInstall(appResults, envName);
-            downloadOpts.values = {
-                ...(resumePreset?.downloadPreset ?? {}),
-                ...downloadOpts.values,
-                ...Install.buildDownloadPresetValuesForInstall(parsed, appResults, envName, yes),
-            };
-            downloadOpts.yes = yes;
-            downloadResults = await runPromptCatalog(Download.prompts, downloadOpts);
+        const downloadOpts = Install.buildDownloadPromptOptionsForInstall(appResults, envName);
+        downloadOpts.values = {
+            ...(resumePreset?.downloadPreset ?? {}),
+            ...downloadOpts.values,
+            ...Install.buildDownloadPresetValuesForInstall(parsed, appResults, envName, yes, commandArgv),
+            ...(parsed['skip-download'] ? Install.buildSkipDownloadValues(envName, appResults) : {}),
+        };
+        downloadOpts.yes = yes;
+        const downloadResults = await runPromptCatalog(Download.prompts, downloadOpts);
+        if (parsed['skip-download']) {
+            delete downloadResults.outputDir;
+            delete downloadResults.replace;
+            delete downloadResults.dockerSave;
+            delete downloadResults.devDependencies;
+            delete downloadResults.build;
+            delete downloadResults.buildDts;
         }
         const dbPreset = {
             ...(resumePreset?.dbPreset ?? {}),
-            ...Install.buildDbPresetValuesFromFlags(parsed),
+            ...Install.buildDbPresetValuesFromFlags(parsed, commandArgv),
         };
         const promptedDbResults = await runPromptCatalog(Install.buildDbPromptsCatalog(envName, downloadResults, {
             resume: parsed.resume,
         }), {
             initialValues: {
                 ...downloadResults,
-                ...await Install.buildDbPromptInitialValues({
+                ...(await Install.buildDbPromptInitialValues({
                     flags: {
                         ...parsed,
-                        'db-port': parsed['db-port']
-                            ?? Install.toOptionalPromptString(dbPreset.dbPort),
+                        'db-port': parsed['db-port'] ?? Install.toOptionalPromptString(dbPreset.dbPort),
                     },
                     downloadResults,
                     dbPreset,
-                }),
+                })),
             },
             values: dbPreset,
             yes,
         });
         const dbResults = {
-            ...promptedDbResults,
             ...pickPresetKeys(dbPreset, ['dbSchema', 'dbTablePrefix', 'dbUnderscored']),
+            ...promptedDbResults,
         };
-        const rootPreset = Install.buildRootPresetValuesFromFlags(parsed);
+        const rootPreset = Install.buildRootPresetValuesFromFlags(parsed, commandArgv);
         const rootResults = await runPromptCatalog(Install.rootUserPrompts, {
             initialValues: {},
             values: {
@@ -2199,18 +2221,44 @@ export default class Install extends Command {
             yes,
         });
         const envAddPromptsForInstall = this.buildEnvAddPromptsForInstall(parsed);
-        const envAddResults = await runPromptCatalog(envAddPromptsForInstall, {
-            initialValues: {
-                apiBaseUrl: `http://127.0.0.1:${appResults.appPort ?? DEFAULT_INSTALL_APP_PORT}/api`,
-            },
+        const envAddResumePreset = resumePreset?.envAddPreset ?? {};
+        const envAddFlagValues = Install.buildEnvAddPresetValuesFromFlags(parsed, commandArgv);
+        const envAddPreset = {
+            ...envAddResumePreset,
+            ...envAddFlagValues,
+        };
+        const resolvedEnvAddAuthType = String(envAddPreset.authType ?? '').trim();
+        const envAddInitialValues = {
+            apiBaseUrl: `http://127.0.0.1:${appResults.appPort ?? DEFAULT_INSTALL_APP_PORT}/api`,
+            ...envAddResumePreset,
+            ...(!parsed['skip-auth'] && resolvedEnvAddAuthType === 'basic'
+                ? {
+                    ...(!Object.prototype.hasOwnProperty.call(envAddResumePreset, 'username') &&
+                        !Object.prototype.hasOwnProperty.call(envAddFlagValues, 'username') &&
+                        rootResults.rootUsername !== undefined
+                        ? { username: String(rootResults.rootUsername).trim() }
+                        : {}),
+                    ...(!Object.prototype.hasOwnProperty.call(envAddFlagValues, 'password') &&
+                        rootResults.rootPassword !== undefined
+                        ? { password: String(rootResults.rootPassword ?? '') }
+                        : {}),
+                }
+                : {}),
+        };
+        const promptedEnvAddResults = await runPromptCatalog(envAddPromptsForInstall, {
+            initialValues: envAddInitialValues,
             values: {
                 name: envName,
                 ...(parsed['skip-auth'] ? { skipAuth: true } : {}),
-                ...(resumePreset?.envAddPreset ?? {}),
-                ...Install.buildEnvAddPresetValuesFromFlags(parsed),
+                ...envAddFlagValues,
             },
             yes,
         });
+        const envAddResults = {
+            ...pickPresetKeys(envAddInitialValues, ['username', 'password']),
+            ...promptedEnvAddResults,
+            ...pickPresetKeys(envAddFlagValues, ['username', 'password']),
+        };
         return {
             envName,
             envResults,
@@ -2243,16 +2291,27 @@ export default class Install extends Command {
                 : 'Resuming setup from the saved workspace config');
         }
         const promptResults = await this.collectPromptResults(parsed, flags.yes);
-        const { envName, appResults, downloadResults, dbResults, rootResults, envAddResults, } = promptResults;
+        const { envName, appResults, downloadResults, dbResults, rootResults, envAddResults } = promptResults;
+        await this.ensureManagedAppRuntimeConfig({
+            envName,
+            appResults,
+        });
         const source = String(downloadResultsValue(downloadResults, 'source') ?? '').trim();
-        const usesDockerResources = Boolean(dbResults.builtinDb)
-            || (Boolean(appResults.fetchSource) && source === 'docker');
+        const usesDockerResources = Boolean(dbResults.builtinDb) || source === 'docker';
         const dockerNetworkName = usesDockerResources
             ? await resolveDockerNetworkName({ scope: resolveDefaultConfigScope() })
             : undefined;
         const dockerContainerPrefix = usesDockerResources
             ? await resolveDockerContainerPrefix({ scope: resolveDefaultConfigScope() })
             : undefined;
+        if (parsed['skip-download']) {
+            await this.ensureSkippedDownloadInputsReady({
+                source,
+                envName,
+                appResults,
+                downloadResults,
+            });
+        }
         await Install.ensureExternalDbReadyForInstall(dbResults);
         if (!parsed.resume) {
             if (!parsed['skip-save-env-log']) {
@@ -2271,7 +2330,7 @@ export default class Install extends Command {
             }
         }
         let builtinDbPlan;
-        if (Boolean(dbResults.builtinDb)) {
+        if (dbResults.builtinDb) {
             builtinDbPlan = await this.startBuiltinDb({
                 envName,
                 dockerNetworkName,
@@ -2291,14 +2350,16 @@ export default class Install extends Command {
         }
         let dockerAppPlan;
         let localAppPlan;
-        if (Boolean(appResults.fetchSource)) {
+        if (source === 'docker' || source === 'npm' || source === 'git') {
             this.logStage('Preparing application');
             if (source === 'docker') {
-                await this.downloadManagedSource({
-                    downloadResults,
-                    verbose: parsed.verbose,
-                });
-                printInfo('Application image ready.');
+                if (!parsed['skip-download']) {
+                    await this.downloadManagedSource({
+                        downloadResults,
+                        verbose: parsed.verbose,
+                    });
+                    printInfo('Application image ready.');
+                }
                 dockerAppPlan = await this.installDockerApp({
                     envName,
                     dockerNetworkName,
@@ -2316,13 +2377,21 @@ export default class Install extends Command {
             }
             else if (source === 'npm' || source === 'git') {
                 const localSource = source === 'npm' ? 'npm' : 'git';
-                const projectRoot = await this.downloadLocalApp({
-                    envName,
-                    appResults,
-                    downloadResults,
-                    verbose: parsed.verbose,
-                });
-                printInfo('Application files ready.');
+                const projectRoot = parsed['skip-download']
+                    ? Install.resolveLocalProjectRoot({
+                        envName,
+                        appResults,
+                        downloadResults,
+                    })
+                    : await this.downloadLocalApp({
+                        envName,
+                        appResults,
+                        downloadResults,
+                        verbose: parsed.verbose,
+                    });
+                if (!parsed['skip-download']) {
+                    printInfo('Application files ready.');
+                }
                 localAppPlan = await this.startLocalApp({
                     envName,
                     source: localSource,
@@ -2346,6 +2415,7 @@ export default class Install extends Command {
                 envAddResults,
             }), {
                 containerName: dockerAppPlan?.containerName,
+                verbose: parsed.verbose,
             });
             printInfo(`NocoBase is ready at http://127.0.0.1:${dockerAppPlan?.appPort ?? localAppPlan?.appPort}`);
         }