@nocobase/cli 2.1.0-alpha.25 → 2.1.0-alpha.27

package/dist/commands/install.js

@@ -16,12 +16,16 @@ 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 { resolveConfiguredEnvPath, resolveDefaultConfigScope, resolveEnvRelativePath, } from '../lib/cli-home.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 { findAvailableTcpPort, validateAvailableTcpPort, validateTcpPort, validateEnvKey, } from "../lib/prompt-validators.js";
+import { validateExternalDbConfig } from "../lib/db-connection-check.js";
 import { formatMissingManagedAppEnvMessage } from '../lib/app-runtime.js';
 import { run, runNocoBaseCommand } from '../lib/run-npm.js';
 import { startTask, stopTask, updateTask } from '../lib/ui.js';
-import { ensureWorkspaceName, getEnv } from '../lib/auth-store.js';
+import { getEnv, upsertEnv } from '../lib/auth-store.js';
+import { buildStoredEnvConfig } from '../lib/env-config.js';
 import Download, { defaultDockerRegistryForLang, } from './download.js';
 import EnvAdd from "./env/add.js";
 const DEFAULT_INSTALL_ENV_NAME = 'local';
@@ -179,6 +183,16 @@ function validateBuiltinDbEnabled(value, values) {
     }
     return translateCli('commands.install.validation.builtinDbUnsupported', { dialect });
 }
+async function validateExternalDbPromptField(value, values) {
+    const builtinDb = values.builtinDb === undefined ? true : Boolean(values.builtinDb);
+    if (builtinDb) {
+        return undefined;
+    }
+    if (typeof value === 'string' && value.trim() === '') {
+        return undefined;
+    }
+    return await validateExternalDbConfig(values);
+}
 function defaultInstallAppRootPath(envName) {
     const name = String(envName ?? DEFAULT_INSTALL_ENV_NAME).trim() || DEFAULT_INSTALL_ENV_NAME;
     return `./${name}/source/`;
@@ -245,7 +259,8 @@ async function commandOutput(command, args, options) {
     });
 }
 export default class Install extends Command {
-    static description = 'Install NocoBase: database, storage, admin user, and `nocobase-v1 install`. Optionally run `nb download` first; distribution and image details are configured on `nb download`, not here. Use `--resume` to continue an interrupted setup from the saved workspace env config.';
+    static hidden = true;
+    static description = 'Install NocoBase: database, storage, admin user, and `nocobase-v1 install`. Optionally run `nb source download` first; distribution and image details are configured on `nb source download`, not here. Use `--resume` to continue an interrupted setup from the saved workspace env config.';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --env app1',
@@ -276,6 +291,25 @@ export default class Install extends Command {
             char: 'e',
             description: 'App/env name to create or update. Defaults app paths to ./<envName>/source/ and ./<envName>/storage/.',
         }),
+        'default-api-base-url': Flags.string({
+            char: 'd',
+            hidden: true,
+            description: 'Default API base URL for HTTP API calls, including the /api prefix (e.g. http://localhost:13000/api)',
+        }),
+        'api-base-url': Flags.string({
+            char: 'u',
+            description: 'Root URL for HTTP API calls, including the /api prefix (e.g. http://localhost:13000/api)',
+        }),
+        'auth-type': Flags.string({
+            char: 'a',
+            description: 'Authentication: token (API key) or oauth (browser login via `nb env auth`)',
+            options: ['token', 'oauth'],
+        }),
+        'access-token': Flags.string({
+            char: 't',
+            aliases: ['token'],
+            description: 'API key or access token when using --auth-type token',
+        }),
         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',
@@ -374,7 +408,7 @@ export default class Install extends Command {
             type: 'text',
             message: installText('prompts.appPort.message'),
             placeholder: installText('prompts.appPort.placeholder'),
-            validate: validateAvailableTcpPort,
+            validate: Install.validateAppPort,
         },
         storagePath: {
             type: 'text',
@@ -426,6 +460,7 @@ export default class Install extends Command {
             initialValue: (values) => defaultDbHostForBuiltinDb(values),
             yesInitialValue: DEFAULT_INSTALL_BUILTIN_DB_HOST,
             required: true,
+            validate: validateExternalDbPromptField,
             hidden: (values) => Boolean(values.builtinDb),
         },
         dbPort: {
@@ -434,7 +469,7 @@ export default class Install extends Command {
             placeholder: installText('prompts.dbPort.placeholder'),
             initialValue: (values) => defaultDbPortForDialect(values.dbDialect),
             required: true,
-            validate: validateTcpPort,
+            validate: Install.validateDbPort,
             hidden: (values) => Boolean(values.builtinDb)
                 && String(values.source ?? '').trim() === 'docker',
         },
@@ -443,6 +478,7 @@ export default class Install extends Command {
             message: installText('prompts.dbDatabase.message'),
             initialValue: (values) => defaultDbDatabaseForDialect(values.dbDialect),
             required: true,
+            validate: validateExternalDbPromptField,
         },
         dbUser: {
             type: 'text',
@@ -450,6 +486,7 @@ export default class Install extends Command {
             initialValue: DEFAULT_INSTALL_DB_USER,
             yesInitialValue: DEFAULT_INSTALL_DB_USER,
             required: true,
+            validate: validateExternalDbPromptField,
         },
         dbPassword: {
             type: 'password',
@@ -457,6 +494,7 @@ export default class Install extends Command {
             initialValue: DEFAULT_INSTALL_DB_PASSWORD,
             yesInitialValue: DEFAULT_INSTALL_DB_PASSWORD,
             required: true,
+            validate: validateExternalDbPromptField,
         },
     };
     static rootUserPrompts = {
@@ -492,7 +530,7 @@ export default class Install extends Command {
      * App catalog with `env` seeded into `out` first so `storagePath`’s `initialValue(values)`
      * sees `values.env` (same iteration order as {@link runPromptCatalog}).
      */
-    static buildAppPromptsCatalog(seedEnv) {
+    static buildAppPromptsCatalog(seedEnv, options) {
         return {
             seedEnv: {
                 type: 'run',
@@ -500,12 +538,27 @@ export default class Install extends Command {
                     values.env = seedEnv;
                 },
             },
+            seedResume: {
+                type: 'run',
+                run: (values) => {
+                    const record = values;
+                    record.resume = Boolean(options?.resume);
+                },
+            },
             ...Install.appPrompts,
         };
     }
-    static buildDbPromptsCatalog(downloadResults) {
+    static buildDbPromptsCatalog(envName, downloadResults, options) {
         const source = String(downloadResults.source ?? '').trim();
         return {
+            seedEnv: {
+                type: 'run',
+                run: (values) => {
+                    if (envName) {
+                        values.env = envName;
+                    }
+                },
+            },
             seedDownloadSource: {
                 type: 'run',
                 run: (values) => {
@@ -514,6 +567,13 @@ export default class Install extends Command {
                     }
                 },
             },
+            seedResume: {
+                type: 'run',
+                run: (values) => {
+                    const record = values;
+                    record.resume = Boolean(options?.resume);
+                },
+            },
             ...Install.dbPrompts,
         };
     }
@@ -533,6 +593,25 @@ export default class Install extends Command {
     static buildPresetValuesFromFlags(flags) {
         const preset = {};
         const argv = process.argv.slice(2);
+        const apiBaseUrl = Install.toOptionalPromptString(flags['api-base-url']);
+        if (apiBaseUrl) {
+            preset.apiBaseUrl = apiBaseUrl;
+        }
+        else if (flags['default-api-base-url'] !== undefined) {
+            const defaultApiBaseUrl = Install.toOptionalPromptString(flags['default-api-base-url']);
+            if (defaultApiBaseUrl) {
+                preset.apiBaseUrl = defaultApiBaseUrl;
+            }
+        }
+        if (flags['auth-type'] !== undefined) {
+            const authType = Install.toOptionalPromptString(flags['auth-type']);
+            if (authType) {
+                preset.authType = authType;
+            }
+        }
+        if (flags['access-token'] !== undefined || flags.token !== undefined) {
+            preset.accessToken = String(flags['access-token'] ?? flags.token ?? '');
+        }
         if (flags.lang !== undefined) {
             const v = String(flags.lang).trim();
             if (v) {
@@ -650,6 +729,13 @@ export default class Install extends Command {
             'rootNickname',
         ]);
     }
+    static buildEnvAddPresetValuesFromFlags(flags) {
+        return pickPresetKeys(Install.buildPresetValuesFromFlags(flags), [
+            'apiBaseUrl',
+            'authType',
+            'accessToken',
+        ]);
+    }
     static toOptionalPromptString(value) {
         if (value === undefined || value === null) {
             return undefined;
@@ -657,6 +743,150 @@ export default class Install extends Command {
         const text = String(value).trim();
         return text || undefined;
     }
+    static async validateAppPort(value, values) {
+        const formatError = validateTcpPort(value);
+        if (formatError) {
+            return formatError;
+        }
+        return await Install.validateResumeAwareTcpPort(value, values, 'app');
+    }
+    static async validateDbPort(value, values) {
+        const formatError = validateTcpPort(value);
+        if (formatError) {
+            return formatError;
+        }
+        const builtinDb = values.builtinDb === undefined ? true : Boolean(values.builtinDb);
+        const source = String(values.source ?? '').trim();
+        if (!builtinDb || source === 'docker') {
+            if (!builtinDb) {
+                return await validateExternalDbConfig({ ...values, dbPort: value });
+            }
+            return undefined;
+        }
+        return await Install.validateResumeAwareTcpPort(value, values, 'db');
+    }
+    static async validateResumeAwareTcpPort(value, values, target) {
+        const portError = await validateAvailableTcpPort(value);
+        if (!portError) {
+            return undefined;
+        }
+        const context = await Install.readResumePortValidationContext(values);
+        if (!context) {
+            return portError;
+        }
+        const port = Install.toOptionalPromptString(value);
+        if (!port) {
+            return portError;
+        }
+        const reusesManagedPort = await Install.isResumeManagedPortReuse({
+            target,
+            port,
+            context,
+        });
+        return reusesManagedPort ? undefined : portError;
+    }
+    static async ensureExternalDbReadyForInstall(dbResults) {
+        const builtinDb = dbResults.builtinDb === undefined ? true : Boolean(dbResults.builtinDb);
+        if (builtinDb) {
+            return;
+        }
+        const dialect = String(dbResults.dbDialect ?? 'postgres').trim() || 'postgres';
+        const host = String(dbResults.dbHost ?? '').trim();
+        const port = String(dbResults.dbPort ?? '').trim();
+        const database = String(dbResults.dbDatabase ?? '').trim();
+        const address = host && port ? `${host}:${port}` : host || port || '(unknown address)';
+        const target = database ? `${address}/${database}` : address;
+        p.log.step(`Checking external ${dialect} database: ${target}`);
+        const validationError = await validateExternalDbConfig(dbResults);
+        if (validationError) {
+            throw new Error(validationError);
+        }
+    }
+    static async readResumePortValidationContext(values) {
+        if (!Boolean(values.resume)) {
+            return undefined;
+        }
+        const envName = Install.toOptionalPromptString(values.env);
+        if (!envName) {
+            return undefined;
+        }
+        const source = Install.toOptionalPromptString(values.source);
+        const builtinDb = values.builtinDb === undefined ? undefined : Boolean(values.builtinDb);
+        const dbDialect = Install.toOptionalPromptString(values.dbDialect);
+        const appRootPath = Install.toOptionalPromptString(values.appRootPath);
+        const dockerNetworkName = await Install.resolveResumeDockerNetworkName();
+        const dockerContainerPrefix = await Install.resolveResumeDockerContainerPrefix();
+        return {
+            envName,
+            ...(dockerNetworkName ? { dockerNetworkName } : {}),
+            ...(dockerContainerPrefix ? { dockerContainerPrefix } : {}),
+            ...(source ? { source } : {}),
+            ...(builtinDb !== undefined ? { builtinDb } : {}),
+            ...(dbDialect ? { dbDialect } : {}),
+            ...(appRootPath ? { appRootPath } : {}),
+        };
+    }
+    static async resolveResumeDockerNetworkName() {
+        return await resolveDockerNetworkName({ scope: resolveDefaultConfigScope() });
+    }
+    static async resolveResumeDockerContainerPrefix() {
+        return await resolveDockerContainerPrefix({ scope: resolveDefaultConfigScope() });
+    }
+    static async isResumeManagedPortReuse(params) {
+        if (params.target === 'app') {
+            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);
+            return await Install.isDockerContainerPublishingPort(containerName, params.port);
+        }
+        if (!params.context.builtinDb || params.context.source === 'docker') {
+            return false;
+        }
+        const containerName = Install.buildBuiltinDbContainerName(params.context.envName, params.context.dbDialect ?? 'postgres', params.context.dockerContainerPrefix);
+        return await Install.isDockerContainerPublishingPort(containerName, params.port);
+    }
+    static async isDockerContainerPublishingPort(containerName, port) {
+        if (!containerName || !port) {
+            return false;
+        }
+        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}`));
+        }
+        catch {
+            return false;
+        }
+    }
+    static async isLocalPm2ProcessUsingPort(appRootPath, port) {
+        const cwd = resolveConfiguredEnvPath(appRootPath);
+        if (!cwd) {
+            return false;
+        }
+        try {
+            const output = await commandOutput('pm2', ['jlist'], { cwd });
+            const rows = JSON.parse(output);
+            return rows.some((row) => {
+                const pmCwd = Install.toOptionalPromptString(row.pm2_env?.pm_cwd);
+                const appPort = Install.toOptionalPromptString(row.pm2_env?.env?.APP_PORT);
+                return Boolean(pmCwd && appPort && pmCwd === cwd && appPort === port);
+            });
+        }
+        catch {
+            return false;
+        }
+    }
     static buildResumePresetValues(env) {
         const envName = String(env.name ?? '').trim();
         const config = env.config ?? {};
@@ -676,6 +906,10 @@ export default class Install extends Command {
         const dbUser = Install.toOptionalPromptString(config.dbUser);
         const dbPassword = Install.toOptionalPromptString(config.dbPassword);
         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 appPreset = {
             ...(appRootPath ? { appRootPath } : {}),
@@ -717,6 +951,12 @@ export default class Install extends Command {
             ...(dbUser ? { dbUser } : {}),
             ...(dbPassword ? { dbPassword } : {}),
         };
+        const rootPreset = {
+            ...(rootUsername ? { rootUsername } : {}),
+            ...(rootEmail ? { rootEmail } : {}),
+            ...(rootPassword ? { rootPassword } : {}),
+            ...(rootNickname ? { rootNickname } : {}),
+        };
         const envAddPreset = {};
         if (auth?.type === 'token') {
             envAddPreset.authType = 'token';
@@ -734,6 +974,7 @@ export default class Install extends Command {
             appPreset,
             downloadPreset,
             dbPreset,
+            rootPreset,
             envAddPreset,
         };
     }
@@ -770,7 +1011,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 install --env ${env.name} --resume\` without \`--yes\`, or pass those flags again.`,
+                    `Run \`nb init --env ${env.name} --resume\` without \`--yes\`, or pass those flags again.`,
                 ].join('\n'));
             }
         }
@@ -943,27 +1184,33 @@ export default class Install extends Command {
             .replace(/^-+|-+$/g, '');
         return normalized || 'nocobase';
     }
-    static defaultWorkspaceName() {
-        return Install.sanitizeDockerResourceName(`nb-${path.basename(process.cwd())}`);
+    static defaultDockerNetworkName() {
+        return Install.sanitizeDockerResourceName(defaultDockerNetworkName());
     }
-    static buildBuiltinDbResourcePrefix(envName, workspaceName) {
-        void envName;
-        const storedName = String(workspaceName ?? '').trim();
+    static defaultDockerContainerPrefix() {
+        return Install.sanitizeDockerResourceName(defaultDockerContainerPrefix(resolveEnvRoot(resolveDefaultConfigScope())));
+    }
+    static buildBuiltinDbContainerPrefix(containerPrefix) {
+        const storedName = String(containerPrefix ?? '').trim();
         return storedName
             ? Install.sanitizeDockerResourceName(storedName)
-            : Install.defaultWorkspaceName();
+            : Install.defaultDockerContainerPrefix();
     }
-    static async ensureWorkspaceName() {
-        return await ensureWorkspaceName(Install.defaultWorkspaceName(), { scope: resolveDefaultConfigScope() });
+    static buildManagedDockerNetworkName(networkName) {
+        const storedName = String(networkName ?? '').trim();
+        return storedName
+            ? Install.sanitizeDockerResourceName(storedName)
+            : Install.defaultDockerNetworkName();
     }
-    static buildBuiltinDbNetworkName(envName, workspaceName) {
-        return Install.buildBuiltinDbResourcePrefix(envName, workspaceName);
+    static buildBuiltinDbNetworkName(envName, networkName) {
+        void envName;
+        return Install.buildManagedDockerNetworkName(networkName);
     }
-    static buildBuiltinDbContainerName(envName, dbDialect, workspaceName) {
-        return Install.sanitizeDockerResourceName(`${Install.buildBuiltinDbResourcePrefix(envName, workspaceName)}-${envName}-${dbDialect}`);
+    static buildBuiltinDbContainerName(envName, dbDialect, containerPrefix) {
+        return Install.sanitizeDockerResourceName(`${Install.buildBuiltinDbContainerPrefix(containerPrefix)}-${envName}-${dbDialect}`);
     }
-    static buildDockerAppContainerName(envName, workspaceName) {
-        return Install.sanitizeDockerResourceName(`${Install.buildBuiltinDbResourcePrefix(envName, workspaceName)}-${envName}-app`);
+    static buildDockerAppContainerName(envName, containerPrefix) {
+        return Install.sanitizeDockerResourceName(`${Install.buildBuiltinDbContainerPrefix(containerPrefix)}-${envName}-app`);
     }
     static buildInitAppEnvVars(params) {
         const out = {};
@@ -989,8 +1236,8 @@ export default class Install extends Command {
         const dbPort = String(params.dbPort ?? defaultDbPortForDialect(dbDialect)).trim()
             || defaultDbPortForDialect(dbDialect);
         const defaultDbDatabase = defaultDbDatabaseForDialect(dbDialect);
-        const networkName = Install.buildBuiltinDbNetworkName(params.envName, params.workspaceName);
-        const containerName = Install.buildBuiltinDbContainerName(params.envName, dbDialect, params.workspaceName);
+        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
@@ -1280,6 +1527,8 @@ export default class Install extends Command {
         const plan = Install.buildBuiltinDbPlan({
             envName: params.envName,
             workspaceName: params.workspaceName,
+            dockerNetworkName: params.dockerNetworkName,
+            dockerContainerPrefix: params.dockerContainerPrefix,
             storagePath,
             source: params.downloadResults.source,
             dbDialect: params.dbResults.dbDialect,
@@ -1327,7 +1576,7 @@ export default class Install extends Command {
         const dbPassword = String(params.dbResults.dbPassword ?? DEFAULT_INSTALL_DB_PASSWORD) || DEFAULT_INSTALL_DB_PASSWORD;
         const appKey = crypto.randomBytes(32).toString('hex');
         const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
-        const containerName = Install.buildDockerAppContainerName(params.envName, params.workspaceName);
+        const containerName = Install.buildDockerAppContainerName(params.envName, params.dockerContainerPrefix ?? params.workspaceName);
         const initEnvVars = Install.buildInitAppEnvVars({
             appResults: params.appResults,
             rootResults: params.rootResults,
@@ -1375,11 +1624,12 @@ export default class Install extends Command {
     }
     async installDockerApp(params) {
         const networkName = params.builtinDbPlan?.networkName
-            ?? Install.buildBuiltinDbNetworkName(params.envName, params.workspaceName);
+            ?? Install.buildBuiltinDbNetworkName(params.envName, params.dockerNetworkName ?? params.workspaceName);
         await this.ensureDockerNetwork(networkName);
         const plan = Install.buildDockerAppPlan({
             envName: params.envName,
             workspaceName: params.workspaceName,
+            dockerContainerPrefix: params.dockerContainerPrefix,
             appResults: params.appResults,
             downloadResults: params.downloadResults,
             dbResults: params.dbResults,
@@ -1468,7 +1718,7 @@ export default class Install extends Command {
         p.log.step(source === 'docker'
             ? 'Downloading Docker image'
             : 'Downloading local NocoBase app files');
-        return await this.config.runCommand('download', argv);
+        return await this.config.runCommand('source:download', argv);
     }
     async downloadLocalApp(params) {
         const result = await this.downloadManagedSource({
@@ -1657,21 +1907,20 @@ export default class Install extends Command {
         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 this.config.runCommand('env:add', Install.buildEnvAddArgv(params));
-    }
-    static pushArgIfValue(argv, flag, value) {
-        const text = String(value ?? '').trim();
-        if (text) {
-            argv.push(flag, text);
-        }
+        await upsertEnv(params.envName, Install.buildSavedEnvConfig(params), { scope: resolveDefaultConfigScope() });
     }
-    static pushBooleanArgIfSet(argv, flag, value) {
-        if (value === undefined) {
+    async syncInstalledEnvConnection(params) {
+        if (!params.appReady) {
             return;
         }
-        argv.push(Boolean(value) ? flag : `--no-${flag.replace(/^--/, '')}`);
+        const authType = String(params.envAddResults.authType ?? 'oauth').trim()
+            || 'oauth';
+        if (authType === 'oauth') {
+            await this.config.runCommand('env:auth', [params.envName]);
+        }
+        await this.config.runCommand('env:update', [params.envName]);
     }
-    static buildEnvAddArgv(params) {
+    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()
@@ -1682,42 +1931,37 @@ export default class Install extends Command {
         });
         const authType = String(params.envAddResults.authType ?? 'oauth').trim()
             || 'oauth';
-        const argv = [
-            params.envName,
-            '--no-intro',
-            '--api-base-url',
+        return buildStoredEnvConfig({
             apiBaseUrl,
-            '--auth-type',
             authType,
-            '--app-port',
+            accessToken: params.envAddResults.accessToken,
+            source: downloadResultsValue(params.downloadResults, 'source'),
+            downloadVersion: downloadResultsValue(params.downloadResults, 'version'),
+            dockerRegistry: downloadResultsValue(params.downloadResults, 'dockerRegistry'),
+            dockerPlatform: downloadResultsValue(params.downloadResults, 'dockerPlatform'),
+            gitUrl: downloadResultsValue(params.downloadResults, 'gitUrl'),
+            npmRegistry: downloadResultsValue(params.downloadResults, 'npmRegistry'),
+            devDependencies: downloadResultsValue(params.downloadResults, 'devDependencies'),
+            build: downloadResultsValue(params.downloadResults, 'build'),
+            buildDts: downloadResultsValue(params.downloadResults, 'buildDts'),
+            appRootPath: params.appResults.appRootPath,
             appPort,
-            '--storage-path',
             storagePath,
-        ];
-        Install.pushArgIfValue(argv, '--source', downloadResultsValue(params.downloadResults, 'source'));
-        Install.pushArgIfValue(argv, '--download-version', downloadResultsValue(params.downloadResults, 'version'));
-        Install.pushArgIfValue(argv, '--docker-registry', downloadResultsValue(params.downloadResults, 'dockerRegistry'));
-        Install.pushArgIfValue(argv, '--docker-platform', downloadResultsValue(params.downloadResults, 'dockerPlatform'));
-        Install.pushArgIfValue(argv, '--git-url', downloadResultsValue(params.downloadResults, 'gitUrl'));
-        Install.pushArgIfValue(argv, '--npm-registry', downloadResultsValue(params.downloadResults, 'npmRegistry'));
-        Install.pushBooleanArgIfSet(argv, '--dev-dependencies', downloadResultsValue(params.downloadResults, 'devDependencies'));
-        Install.pushBooleanArgIfSet(argv, '--build', downloadResultsValue(params.downloadResults, 'build'));
-        Install.pushBooleanArgIfSet(argv, '--build-dts', downloadResultsValue(params.downloadResults, 'buildDts'));
-        Install.pushArgIfValue(argv, '--app-root-path', params.appResults.appRootPath);
-        Install.pushArgIfValue(argv, '--app-key', params.appResults.appKey);
-        Install.pushArgIfValue(argv, '--timezone', params.appResults.timeZone);
-        Install.pushBooleanArgIfSet(argv, '--builtin-db', params.dbResults.builtinDb);
-        Install.pushArgIfValue(argv, '--db-dialect', params.dbResults.dbDialect);
-        Install.pushArgIfValue(argv, '--builtin-db-image', params.dbResults.builtinDbImage);
-        Install.pushArgIfValue(argv, '--db-host', params.dbResults.dbHost);
-        Install.pushArgIfValue(argv, '--db-port', params.dbResults.dbPort);
-        Install.pushArgIfValue(argv, '--db-database', params.dbResults.dbDatabase);
-        Install.pushArgIfValue(argv, '--db-user', params.dbResults.dbUser);
-        Install.pushArgIfValue(argv, '--db-password', params.dbResults.dbPassword);
-        if (authType === 'token') {
-            argv.push('--access-token', String(params.envAddResults.accessToken ?? ''));
-        }
-        return argv;
+            appKey: params.appResults.appKey,
+            timezone: params.appResults.timeZone,
+            builtinDb: params.dbResults.builtinDb,
+            dbDialect: params.dbResults.dbDialect,
+            builtinDbImage: params.dbResults.builtinDbImage,
+            dbHost: params.dbResults.dbHost,
+            dbPort: params.dbResults.dbPort,
+            dbDatabase: params.dbResults.dbDatabase,
+            dbUser: params.dbResults.dbUser,
+            dbPassword: params.dbResults.dbPassword,
+            rootUsername: params.rootResults.rootUsername,
+            rootEmail: params.rootResults.rootEmail,
+            rootPassword: params.rootResults.rootPassword,
+            rootNickname: params.rootResults.rootNickname,
+        });
     }
     async collectPromptResults(parsed, yes) {
         const resumePreset = await this.resolveResumePresetValues(parsed, yes);
@@ -1737,7 +1981,9 @@ export default class Install extends Command {
             ...(resumePreset?.appPreset ?? {}),
             ...Install.buildAppPresetValuesFromFlags(parsed),
         };
-        const appCatalog = Install.buildAppPromptsCatalog(envName);
+        const appCatalog = Install.buildAppPromptsCatalog(envName, {
+            resume: parsed.resume,
+        });
         const appResults = await runPromptCatalog(appCatalog, {
             initialValues: await Install.buildAppPromptInitialValues({
                 envName,
@@ -1752,6 +1998,7 @@ export default class Install extends Command {
                 },
             }),
             values: appPreset,
+            yesInitialValues: { resume: parsed.resume },
             yes,
         });
         let downloadResults = {};
@@ -1769,7 +2016,9 @@ export default class Install extends Command {
             ...(resumePreset?.dbPreset ?? {}),
             ...Install.buildDbPresetValuesFromFlags(parsed),
         };
-        const dbResults = await runPromptCatalog(Install.buildDbPromptsCatalog(downloadResults), {
+        const dbResults = await runPromptCatalog(Install.buildDbPromptsCatalog(envName, downloadResults, {
+            resume: parsed.resume,
+        }), {
             initialValues: {
                 ...downloadResults,
                 ...await Install.buildDbPromptInitialValues({
@@ -1788,7 +2037,10 @@ export default class Install extends Command {
         const rootPreset = Install.buildRootPresetValuesFromFlags(parsed);
         const rootResults = await runPromptCatalog(Install.rootUserPrompts, {
             initialValues: {},
-            values: rootPreset,
+            values: {
+                ...(resumePreset?.rootPreset ?? {}),
+                ...rootPreset,
+            },
             yes,
         });
         const envAddResults = await runPromptCatalog(EnvAdd.prompts, {
@@ -1798,6 +2050,7 @@ export default class Install extends Command {
             values: {
                 name: envName,
                 ...(resumePreset?.envAddPreset ?? {}),
+                ...Install.buildEnvAddPresetValuesFromFlags(parsed),
             },
             yes,
         });
@@ -1833,14 +2086,30 @@ export default class Install extends Command {
         const source = String(downloadResultsValue(downloadResults, 'source') ?? '').trim();
         const usesDockerResources = Boolean(dbResults.builtinDb)
             || (Boolean(appResults.fetchSource) && source === 'docker');
-        const workspaceName = usesDockerResources
-            ? await Install.ensureWorkspaceName()
+        const dockerNetworkName = usesDockerResources
+            ? await resolveDockerNetworkName({ scope: resolveDefaultConfigScope() })
             : undefined;
+        const dockerContainerPrefix = usesDockerResources
+            ? await resolveDockerContainerPrefix({ scope: resolveDefaultConfigScope() })
+            : undefined;
+        await Install.ensureExternalDbReadyForInstall(dbResults);
+        if (!parsed.resume) {
+            await this.saveInstalledEnv({
+                envName,
+                appResults,
+                downloadResults,
+                dbResults,
+                rootResults,
+                envAddResults,
+            });
+            p.log.info(`Saved install config for env "${envName}"`);
+        }
         let builtinDbPlan;
         if (Boolean(dbResults.builtinDb)) {
             builtinDbPlan = await this.startBuiltinDb({
                 envName,
-                workspaceName,
+                dockerNetworkName,
+                dockerContainerPrefix,
                 appResults,
                 downloadResults,
                 dbResults,
@@ -1864,7 +2133,8 @@ export default class Install extends Command {
                 });
                 dockerAppPlan = await this.installDockerApp({
                     envName,
-                    workspaceName,
+                    dockerNetworkName,
+                    dockerContainerPrefix,
                     appResults,
                     downloadResults,
                     dbResults,
@@ -1877,6 +2147,7 @@ export default class Install extends Command {
                 appResults.timeZone = dockerAppPlan.timeZone;
             }
             else if (source === 'npm' || source === 'git') {
+                const localSource = source === 'npm' ? 'npm' : 'git';
                 const projectRoot = await this.downloadLocalApp({
                     envName,
                     appResults,
@@ -1885,7 +2156,7 @@ export default class Install extends Command {
                 });
                 localAppPlan = await this.startLocalApp({
                     envName,
-                    source,
+                    source: localSource,
                     projectRoot,
                     appResults,
                     dbResults,
@@ -1907,12 +2178,20 @@ export default class Install extends Command {
                 containerName: dockerAppPlan?.containerName,
             });
         }
-        await this.saveInstalledEnv({
+        if (dockerAppPlan || localAppPlan || builtinDbPlan) {
+            await this.saveInstalledEnv({
+                envName,
+                appResults,
+                downloadResults,
+                dbResults,
+                rootResults,
+                envAddResults,
+            });
+        }
+        await this.syncInstalledEnvConnection({
             envName,
-            appResults,
-            downloadResults,
-            dbResults,
             envAddResults,
+            appReady: Boolean(dockerAppPlan || localAppPlan),
         });
         p.outro(dockerAppPlan || localAppPlan
             ? `NocoBase is ready at http://127.0.0.1:${dockerAppPlan?.appPort ?? localAppPlan?.appPort}`