@nocobase/cli 2.1.0-beta.35 → 2.1.0-beta.37

package/dist/commands/install.js

@@ -7,27 +7,26 @@
  * 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 Download, { defaultDockerRegistryForLang } from './download.js';
 import EnvAdd from "./env/add.js";
 const DEFAULT_INSTALL_ENV_NAME = 'local';
 const DEFAULT_INSTALL_LANG = 'en-US';
@@ -136,6 +135,20 @@ const INSTALL_LANGUAGE_OPTIONS = Object.entries(INSTALL_LANGUAGE_CODES).map(([va
     label: `${label} (${value})`,
 }));
 const installText = (key, values) => localeText(`commands.install.${key}`, values);
+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.`;
+    }
+    if (normalizedAuthType === 'oauth') {
+        return `${nextStep} A browser sign-in flow will be started.`;
+    }
+    return nextStep;
+}
 function argvHasToken(argv, tokens) {
     return tokens.some((t) => argv.includes(t));
 }
@@ -143,9 +156,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();
@@ -160,22 +171,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';
@@ -192,7 +197,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;
@@ -211,53 +223,39 @@ 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));
-    });
+function optionalEnvString(value) {
+    const text = String(value ?? '').trim();
+    return text || undefined;
 }
-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 optionalEnvBoolean(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    return Boolean(value);
+}
+function pushOptionalEnvArg(args, key, value) {
+    if (typeof value === 'string') {
+        if (!value) {
+            return;
+        }
+        args.push('-e', `${key}=${value}`);
+        return;
+    }
+    if (typeof value === 'boolean') {
+        args.push('-e', `${key}=${String(value)}`);
+    }
+}
+function setOptionalEnvVar(out, key, value) {
+    if (typeof value === 'string') {
+        if (!value) {
+            return;
+        }
+        out[key] = value;
+        return;
+    }
+    if (typeof value === 'boolean') {
+        out[key] = String(value);
+    }
 }
 export default class Install extends Command {
     ensuredDockerNetworks = new Set();
@@ -279,7 +277,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({
@@ -314,14 +312,24 @@ 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,
+        }),
         lang: Flags.string({ description: 'Language for the installed NocoBase app', char: 'l', required: false }),
         force: Flags.boolean({
             description: 'Reconfigure an existing env and replace conflicting runtime resources when needed',
@@ -380,8 +388,19 @@ export default class Install extends Command {
         'db-password': Flags.string({
             description: 'Database password for the app',
         }),
-        'fetch-source': Flags.boolean({
-            description: 'Download NocoBase app files or pull a Docker image before installing',
+        'db-schema': Flags.string({
+            description: 'Database schema for the app',
+        }),
+        'db-table-prefix': Flags.string({
+            description: 'Database table prefix for the app',
+        }),
+        'db-underscored': Flags.boolean({
+            allowNo: true,
+            description: 'Use underscored database naming for the app',
+            default: false,
+        }),
+        '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']),
@@ -428,12 +447,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: {
@@ -461,8 +474,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: {
@@ -482,8 +494,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',
@@ -508,6 +519,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: {
@@ -602,9 +634,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;
@@ -621,9 +652,18 @@ export default class Install extends Command {
                 preset.authType = authType;
             }
         }
+        if (flags['skip-auth']) {
+            preset.skipAuth = true;
+        }
         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) {
@@ -663,8 +703,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'];
@@ -709,20 +756,34 @@ export default class Install extends Command {
         if (flags['db-password'] !== undefined) {
             preset.dbPassword = String(flags['db-password'] ?? '');
         }
+        if (flags['db-schema'] !== undefined) {
+            const v = String(flags['db-schema'] ?? '').trim();
+            if (v) {
+                preset.dbSchema = v;
+            }
+        }
+        if (flags['db-table-prefix'] !== undefined) {
+            const v = String(flags['db-table-prefix'] ?? '').trim();
+            if (v) {
+                preset.dbTablePrefix = v;
+            }
+        }
+        if (argvHasToken(argv, ['--db-underscored', '--no-db-underscored'])) {
+            preset.dbUnderscored = flags['db-underscored'];
+        }
         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',
@@ -731,23 +792,49 @@ export default class Install extends Command {
             'dbDatabase',
             'dbUser',
             'dbPassword',
+            'dbSchema',
+            'dbTablePrefix',
+            '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',
         ]);
     }
+    buildEnvAddPromptsForInstall(parsed) {
+        const apiBaseUrlPrompt = {
+            ...EnvAdd.prompts.apiBaseUrl,
+            validate: undefined,
+        };
+        const prompts = {
+            ...EnvAdd.prompts,
+            apiBaseUrl: apiBaseUrlPrompt,
+        };
+        if (!parsed['skip-auth']) {
+            return prompts;
+        }
+        const accessTokenPrompt = {
+            ...EnvAdd.prompts.accessToken,
+            hidden: () => true,
+        };
+        return {
+            ...prompts,
+            accessToken: accessTokenPrompt,
+        };
+    }
     static toOptionalPromptString(value) {
         if (value === undefined || value === null) {
             return undefined;
@@ -813,9 +900,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);
@@ -846,8 +937,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);
@@ -863,19 +953,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;
@@ -917,39 +1001,34 @@ export default class Install extends Command {
         const dbDatabase = Install.toOptionalPromptString(config.dbDatabase);
         const dbUser = Install.toOptionalPromptString(config.dbUser);
         const dbPassword = Install.toOptionalPromptString(config.dbPassword);
+        const dbSchema = Install.toOptionalPromptString(config.dbSchema);
+        const dbTablePrefix = Install.toOptionalPromptString(config.dbTablePrefix);
+        const dbUnderscored = typeof config.dbUnderscored === 'boolean' ? config.dbUnderscored : undefined;
         const builtinDbImage = Install.toOptionalPromptString(config.builtinDbImage);
         const rootUsername = Install.toOptionalPromptString(config.rootUsername);
         const rootEmail = Install.toOptionalPromptString(config.rootEmail);
         const rootPassword = Install.toOptionalPromptString(config.rootPassword);
         const rootNickname = Install.toOptionalPromptString(config.rootNickname);
         const auth = config.auth;
+        const savedAuthType = Install.toOptionalPromptString(config.authType) ?? Install.toOptionalPromptString(auth?.type);
         const appPreset = {
             ...(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 } : {}),
         };
@@ -962,6 +1041,9 @@ export default class Install extends Command {
             ...(dbDatabase ? { dbDatabase } : {}),
             ...(dbUser ? { dbUser } : {}),
             ...(dbPassword ? { dbPassword } : {}),
+            ...(dbSchema ? { dbSchema } : {}),
+            ...(dbTablePrefix ? { dbTablePrefix } : {}),
+            ...(dbUnderscored !== undefined ? { dbUnderscored } : {}),
         };
         const rootPreset = {
             ...(rootUsername ? { rootUsername } : {}),
@@ -970,13 +1052,20 @@ export default class Install extends Command {
             ...(rootNickname ? { rootNickname } : {}),
         };
         const envAddPreset = {};
-        if (auth?.type === 'token') {
+        if (savedAuthType === 'token') {
             envAddPreset.authType = 'token';
             if (Install.toOptionalPromptString(auth.accessToken)) {
                 envAddPreset.accessToken = String(auth.accessToken);
             }
         }
-        else if (auth?.type === 'oauth') {
+        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';
         }
         return {
@@ -1060,8 +1149,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) {
@@ -1117,9 +1205,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;
@@ -1158,8 +1245,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;
@@ -1203,15 +1289,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;
@@ -1244,25 +1326,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');
@@ -1293,12 +1369,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,
@@ -1484,11 +1557,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], {
@@ -1538,8 +1607,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,
@@ -1577,25 +1645,25 @@ 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 containerName = Install.buildDockerAppContainerName(params.envName, params.dockerContainerPrefix ?? params.workspaceName);
@@ -1623,7 +1691,11 @@ export default class Install extends Command {
         for (const [key, value] of Object.entries(initEnvVars)) {
             args.push('-e', `${key}=${value}`);
         }
-        args.push('-e', `APP_KEY=${appKey}`, '-e', `DB_DIALECT=${dbDialect}`, '-e', `DB_HOST=${dbHost}`, '-e', `DB_PORT=${dbPort}`, '-e', `DB_DATABASE=${dbDatabase}`, '-e', `DB_USER=${dbUser}`, '-e', `DB_PASSWORD=${dbPassword}`, '-e', `TZ=${timeZone}`, '-v', `${storagePath}:/app/nocobase/storage`, imageRef);
+        args.push('-e', `APP_KEY=${appKey}`, '-e', `DB_DIALECT=${dbDialect}`, '-e', `DB_HOST=${dbHost}`, '-e', `DB_PORT=${dbPort}`, '-e', `DB_DATABASE=${dbDatabase}`, '-e', `DB_USER=${dbUser}`, '-e', `DB_PASSWORD=${dbPassword}`, '-e', `TZ=${timeZone}`, '-v', `${storagePath}:/app/nocobase/storage`);
+        pushOptionalEnvArg(args, 'DB_SCHEMA', dbSchema);
+        pushOptionalEnvArg(args, 'DB_TABLE_PREFIX', dbTablePrefix);
+        pushOptionalEnvArg(args, 'DB_UNDERSCORED', dbUnderscored);
+        args.push(imageRef);
         return {
             source: 'docker',
             networkName: params.networkName,
@@ -1651,8 +1723,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,
@@ -1699,26 +1771,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;
@@ -1728,15 +1800,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';
@@ -1746,7 +1829,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({
@@ -1767,36 +1884,32 @@ 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 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 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,
             }),
         };
+        setOptionalEnvVar(env, 'DB_SCHEMA', optionalEnvString(params.dbResults.dbSchema));
+        setOptionalEnvVar(env, 'DB_TABLE_PREFIX', optionalEnvString(params.dbResults.dbTablePrefix));
+        setOptionalEnvVar(env, 'DB_UNDERSCORED', optionalEnvBoolean(params.dbResults.dbUnderscored));
         return env;
     }
     async startLocalApp(params) {
@@ -1838,10 +1951,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`;
@@ -1870,9 +1981,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) {
@@ -1936,28 +2045,42 @@ 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;
+        }
         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'),
@@ -1982,6 +2105,9 @@ export default class Install extends Command {
             dbDatabase: params.dbResults.dbDatabase,
             dbUser: params.dbResults.dbUser,
             dbPassword: params.dbResults.dbPassword,
+            dbSchema: params.dbResults.dbSchema,
+            dbTablePrefix: params.dbResults.dbTablePrefix,
+            dbUnderscored: params.dbResults.dbUnderscored,
             rootUsername: params.rootResults.rootUsername,
             rootEmail: params.rootResults.rootEmail,
             rootPassword: params.rootResults.rootPassword,
@@ -1989,6 +2115,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 ?? {}),
@@ -2004,7 +2131,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,
@@ -2014,52 +2141,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 dbResults = await runPromptCatalog(Install.buildDbPromptsCatalog(envName, downloadResults, {
+        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 rootPreset = Install.buildRootPresetValuesFromFlags(parsed);
+        const dbResults = {
+            ...pickPresetKeys(dbPreset, ['dbSchema', 'dbTablePrefix', 'dbUnderscored']),
+            ...promptedDbResults,
+        };
+        const rootPreset = Install.buildRootPresetValuesFromFlags(parsed, commandArgv);
         const rootResults = await runPromptCatalog(Install.rootUserPrompts, {
             initialValues: {},
             values: {
@@ -2068,24 +2201,45 @@ export default class Install extends Command {
             },
             yes,
         });
-        const envAddPromptsForInstall = {
-            ...EnvAdd.prompts,
-            apiBaseUrl: {
-                ...EnvAdd.prompts.apiBaseUrl,
-                validate: undefined,
-            },
+        const envAddPromptsForInstall = this.buildEnvAddPromptsForInstall(parsed);
+        const envAddResumePreset = resumePreset?.envAddPreset ?? {};
+        const envAddFlagValues = Install.buildEnvAddPresetValuesFromFlags(parsed, commandArgv);
+        const envAddPreset = {
+            ...envAddResumePreset,
+            ...envAddFlagValues,
         };
-        const envAddResults = await runPromptCatalog(envAddPromptsForInstall, {
-            initialValues: {
-                apiBaseUrl: `http://127.0.0.1:${appResults.appPort ?? DEFAULT_INSTALL_APP_PORT}/api`,
-            },
+        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,
-                ...(resumePreset?.envAddPreset ?? {}),
-                ...Install.buildEnvAddPresetValuesFromFlags(parsed),
+                ...(parsed['skip-auth'] ? { skipAuth: true } : {}),
+                ...envAddFlagValues,
             },
             yes,
         });
+        const envAddResults = {
+            ...pickPresetKeys(envAddInitialValues, ['username', 'password']),
+            ...promptedEnvAddResults,
+            ...pickPresetKeys(envAddFlagValues, ['username', 'password']),
+        };
         return {
             envName,
             envResults,
@@ -2103,6 +2257,9 @@ export default class Install extends Command {
         const parsed = {
             ...flags,
         };
+        if (parsed['skip-auth'] && (parsed['access-token'] !== undefined || parsed.token !== undefined)) {
+            this.error('--skip-auth cannot be used with --access-token or --token.');
+        }
         setVerboseMode(Boolean(parsed.verbose));
         const commandStdio = this.commandStdio(parsed.verbose);
         if (!parsed['no-intro']) {
@@ -2115,16 +2272,23 @@ 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;
         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']) {
@@ -2143,7 +2307,7 @@ export default class Install extends Command {
             }
         }
         let builtinDbPlan;
-        if (Boolean(dbResults.builtinDb)) {
+        if (dbResults.builtinDb) {
             builtinDbPlan = await this.startBuiltinDb({
                 envName,
                 dockerNetworkName,
@@ -2163,14 +2327,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,
@@ -2188,13 +2354,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,
@@ -2235,6 +2409,7 @@ export default class Install extends Command {
             envName,
             envAddResults,
             appReady: Boolean(dockerAppPlan || localAppPlan),
+            skipAuth: Boolean(parsed['skip-auth']),
         });
         if (!dockerAppPlan && !localAppPlan) {
             printInfo(`Install config for "${envName}" has been saved.`);