@nocobase/cli 2.1.0-alpha.45 → 2.1.0-alpha.47

package/dist/commands/install.js

@@ -11,23 +11,27 @@ import crypto from 'node:crypto';
 import { access, mkdir } from 'node:fs/promises';
 import path from 'node:path';
 import { exit } from 'node:process';
+import { appendAppPublicPath } from '../lib/app-public-path.js';
 import { runPromptCatalog, } from "../lib/prompt-catalog.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 { resolveDefaultApiHost, 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 { findAvailableTcpPort, validateAppPublicPath, validateAvailableTcpPort, validateTcpPort, validateEnvKey, } from "../lib/prompt-validators.js";
 import { validateExternalDbConfig, validateMysqlLowerCaseTableNamesCompatibility } from "../lib/db-connection-check.js";
 import { formatMissingManagedAppEnvMessage } from '../lib/app-runtime.js';
-import { commandOutput, commandSucceeds, run, runNocoBaseCommand } from '../lib/run-npm.js';
+import { commandOutput, commandSucceeds, ensureDockerDaemonRunning, 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 { clearEnvRootSetup, getEnv, setCurrentEnv, upsertEnv } from '../lib/auth-store.js';
 import { buildStoredEnvConfig } from '../lib/env-config.js';
 import { resolveDockerEnvFileArg } from "../lib/docker-env-file.js";
+import { startDockerLogFollower } from '../lib/docker-log-stream.js';
+import { areConfiguredPathsEquivalent, deriveConfiguredSourcePath, deriveConfiguredStoragePath, inferConfiguredAppPathFromLegacyConfig, } from '../lib/env-paths.js';
 import Download, { defaultDockerRegistryForLang } from './download.js';
 import EnvAdd from "./env/add.js";
+import { resolveAppUrlFromApiBaseUrl } from "./env/shared.js";
 const DEFAULT_INSTALL_ENV_NAME = 'local';
 const DEFAULT_INSTALL_LANG = 'en-US';
 const DEFAULT_INSTALL_APP_PORT = '13000';
@@ -58,6 +62,19 @@ const DEFAULT_INSTALL_ROOT_USERNAME = 'nocobase';
 const DEFAULT_INSTALL_ROOT_EMAIL = 'admin@nocobase.com';
 const DEFAULT_INSTALL_ROOT_PASSWORD = 'admin123';
 const DEFAULT_INSTALL_ROOT_NICKNAME = 'Super Admin';
+const DEFAULT_INSTALL_API_HOST = '127.0.0.1';
+function toOptionalPromptString(value) {
+    const text = String(value ?? '').trim();
+    return text || undefined;
+}
+function buildInstallApiBaseUrl(appResults, defaultApiHost = DEFAULT_INSTALL_API_HOST) {
+    const appPort = String(appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
+    const appPublicPath = String(appResults.appPublicPath ?? '').trim();
+    return `http://${defaultApiHost}:${appPort}${appendAppPublicPath(appPublicPath, 'api', { trailingSlash: false })}`;
+}
+function formatInstallDisplayUrl(apiBaseUrl) {
+    return resolveAppUrlFromApiBaseUrl(apiBaseUrl) || apiBaseUrl.replace(/\/api\/?$/, '');
+}
 const APP_HEALTH_CHECK_INTERVAL_MS = 2_000;
 const APP_HEALTH_CHECK_TIMEOUT_MS = 600_000;
 const APP_HEALTH_CHECK_REQUEST_TIMEOUT_MS = 5_000;
@@ -206,13 +223,41 @@ async function validateExternalDbPromptField(value, values) {
     }
     return await validateMysqlLowerCaseTableNamesCompatibility(values);
 }
-function defaultInstallAppRootPath(envName) {
+function defaultInstallAppPath(envName) {
     const name = String(envName ?? DEFAULT_INSTALL_ENV_NAME).trim() || DEFAULT_INSTALL_ENV_NAME;
-    return `./${name}/source/`;
+    return `./${name}/`;
+}
+function defaultInstallAppRootPath(envName) {
+    return deriveConfiguredSourcePath(defaultInstallAppPath(envName));
 }
 function defaultInstallStoragePath(envName) {
-    const name = String(envName ?? DEFAULT_INSTALL_ENV_NAME).trim() || DEFAULT_INSTALL_ENV_NAME;
-    return `./${name}/storage/`;
+    return deriveConfiguredStoragePath(defaultInstallAppPath(envName));
+}
+function resolveConfiguredAppPathValue(values) {
+    const explicitAppPath = toOptionalPromptString(values.appPath);
+    if (explicitAppPath) {
+        return explicitAppPath;
+    }
+    return inferConfiguredAppPathFromLegacyConfig({
+        appRootPath: toOptionalPromptString(values.appRootPath),
+        storagePath: toOptionalPromptString(values.storagePath),
+    });
+}
+function resolveConfiguredSourcePathValue(values, envName) {
+    const legacyAppRootPath = toOptionalPromptString(values.appRootPath);
+    if (legacyAppRootPath) {
+        return legacyAppRootPath;
+    }
+    const appPath = resolveConfiguredAppPathValue(values) ?? defaultInstallAppPath(envName);
+    return deriveConfiguredSourcePath(appPath);
+}
+function resolveConfiguredStoragePathValue(values, envName) {
+    const legacyStoragePath = toOptionalPromptString(values.storagePath);
+    if (legacyStoragePath) {
+        return legacyStoragePath;
+    }
+    const appPath = resolveConfiguredAppPathValue(values) ?? defaultInstallAppPath(envName);
+    return deriveConfiguredStoragePath(appPath);
 }
 function pickPresetKeys(source, keys) {
     const out = {};
@@ -233,6 +278,15 @@ function optionalEnvBoolean(value) {
     }
     return Boolean(value);
 }
+function resolveExtractClientAssetsDefaultEnabled(value) {
+    const text = String(value ?? '')
+        .trim()
+        .toLowerCase();
+    if (!text) {
+        return true;
+    }
+    return !['0', 'false', 'no', 'off'].includes(text);
+}
 function pushOptionalEnvArg(args, key, value) {
     if (typeof value === 'string') {
         if (!value) {
@@ -275,9 +329,9 @@ export default class Install extends Command {
         '<%= config.bin %> <%= command.id %> --env app1 -l zh-CN',
         '<%= config.bin %> <%= command.id %> --env app1 --root-username nocobase --root-email admin@nocobase.com --root-password admin123',
         '<%= 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 --skip-download --source git --app-root-path=./dev/source/',
+        '<%= config.bin %> <%= command.id %> --env myenv --app-path=./myenv/',
+        '<%= config.bin %> <%= command.id %> --env dev -y --app-path=./dev/',
+        '<%= config.bin %> <%= command.id %> --env dev -y --skip-download --source git --app-path=./dev/',
     ];
     static flags = {
         yes: Flags.boolean({
@@ -299,7 +353,7 @@ export default class Install extends Command {
         }),
         env: Flags.string({
             char: 'e',
-            description: 'App/env name to create or update. Defaults app paths to ./<envName>/source/ and ./<envName>/storage/.',
+            description: 'App/env name to create or update. Defaults the app path to ./<envName>/ and derives source/storage inside it.',
         }),
         'default-api-base-url': Flags.string({
             char: 'd',
@@ -336,14 +390,24 @@ export default class Install extends Command {
             char: 'f',
             required: false,
         }),
+        'app-path': Flags.string({
+            description: 'App directory for a local npm/git app (default: ./<envName>/)',
+        }),
         'app-root-path': Flags.string({
-            description: 'Source directory for a local npm/git app (default: ./<envName>/source/)',
+            hidden: true,
+            deprecated: true,
+            description: 'Legacy source directory for a local npm/git app',
         }),
         'app-port': Flags.string({
             description: 'HTTP port for the local app (default: 13000, or an available port with --yes)',
         }),
         'storage-path': Flags.string({
-            description: 'Storage directory for uploads and managed database data (default: ./<envName>/storage/)',
+            hidden: true,
+            deprecated: true,
+            description: 'Legacy storage directory for uploads and managed database data',
+        }),
+        'app-public-path': Flags.string({
+            description: 'Public path for the local app, for example / or /console/',
         }),
         'root-username': Flags.string({
             description: 'Initial admin username for the installed app',
@@ -415,39 +479,44 @@ export default class Install extends Command {
             validate: validateEnvKey,
         },
     };
-    static appPrompts = {
-        lang: {
-            type: 'select',
-            message: installText('prompts.lang.message'),
-            options: INSTALL_LANGUAGE_OPTIONS,
-            initialValue: DEFAULT_INSTALL_LANG,
-            yesInitialValue: DEFAULT_INSTALL_LANG,
-        },
-        // force: {
-        //   type: 'boolean',
-        //   message: 'Reinstall the application by clearing the database? (-f / --force)',
-        //   initialValue: false,
-        //   yesInitialValue: false,
-        // },
-        appRootPath: {
-            type: 'text',
-            message: installText('prompts.appRootPath.message'),
-            placeholder: installText('prompts.appRootPath.placeholder'),
-            initialValue: (values) => defaultInstallAppRootPath(values.env ?? values.appName),
-        },
-        appPort: {
-            type: 'text',
-            message: installText('prompts.appPort.message'),
-            placeholder: installText('prompts.appPort.placeholder'),
-            validate: Install.validateAppPort,
-        },
-        storagePath: {
-            type: 'text',
-            message: installText('prompts.storagePath.message'),
-            placeholder: installText('prompts.storagePath.placeholder'),
-            initialValue: (values) => defaultInstallStoragePath(values.env ?? values.appName),
-        },
-    };
+    static get appPrompts() {
+        return {
+            lang: {
+                type: 'select',
+                message: installText('prompts.lang.message'),
+                options: INSTALL_LANGUAGE_OPTIONS,
+                initialValue: DEFAULT_INSTALL_LANG,
+                yesInitialValue: DEFAULT_INSTALL_LANG,
+            },
+            // force: {
+            //   type: 'boolean',
+            //   message: 'Reinstall the application by clearing the database? (-f / --force)',
+            //   initialValue: false,
+            //   yesInitialValue: false,
+            // },
+            appPath: {
+                type: 'text',
+                message: installText('prompts.appPath.message', { root: resolveEnvRoot() }),
+                placeholder: installText('prompts.appPath.placeholder'),
+                initialValue: (values) => defaultInstallAppPath(values.env ?? values.appName),
+                hidden: (values) => Boolean(Install.toOptionalPromptString(values.appRootPath)),
+            },
+            appPort: {
+                type: 'text',
+                message: installText('prompts.appPort.message'),
+                placeholder: installText('prompts.appPort.placeholder'),
+                validate: Install.validateAppPort,
+            },
+            appPublicPath: {
+                type: 'text',
+                message: installText('prompts.appPublicPath.message'),
+                placeholder: installText('prompts.appPublicPath.placeholder'),
+                initialValue: '/',
+                yesInitialValue: '/',
+                validate: validateAppPublicPath,
+            },
+        };
+    }
     static dbPrompts = {
         dbDialect: {
             type: 'select',
@@ -571,8 +640,8 @@ 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}).
+     * App catalog with `env` seeded into `out` first so app path defaults can see `values.env`
+     * (same iteration order as {@link runPromptCatalog}).
      */
     static buildAppPromptsCatalog(seedEnv, options) {
         return {
@@ -673,6 +742,12 @@ export default class Install extends Command {
         if (argvHasToken(argv, ['--force', '-f'])) {
             preset.force = flags.force;
         }
+        if (flags['app-path'] !== undefined) {
+            const v = flags['app-path']?.trim();
+            if (v) {
+                preset.appPath = v;
+            }
+        }
         if (flags['app-root-path'] !== undefined) {
             const v = flags['app-root-path']?.trim();
             if (v) {
@@ -691,6 +766,12 @@ export default class Install extends Command {
                 preset.storagePath = v;
             }
         }
+        if (flags['app-public-path'] !== undefined) {
+            const v = String(flags['app-public-path'] ?? '').trim();
+            if (v) {
+                preset.appPublicPath = v;
+            }
+        }
         if (flags['root-username'] !== undefined) {
             preset.rootUsername = String(flags['root-username'] ?? '').trim();
         }
@@ -777,9 +858,11 @@ export default class Install extends Command {
         return pickPresetKeys(Install.buildPresetValuesFromFlags(flags, argv), [
             'lang',
             'force',
+            'appPath',
             'appRootPath',
             'appPort',
             'storagePath',
+            'appPublicPath',
         ]);
     }
     static buildDbPresetValuesFromFlags(flags, argv = process.argv.slice(2)) {
@@ -836,11 +919,26 @@ export default class Install extends Command {
         };
     }
     static toOptionalPromptString(value) {
-        if (value === undefined || value === null) {
-            return undefined;
-        }
-        const text = String(value).trim();
-        return text || undefined;
+        return toOptionalPromptString(value);
+    }
+    static resolveManagedAppKey(value) {
+        return Install.toOptionalPromptString(value) ?? crypto.randomBytes(32).toString('hex');
+    }
+    static resolveManagedTimeZone(value) {
+        return Install.toOptionalPromptString(value) ?? (Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC');
+    }
+    static formatLocalClientExtractWarning(envName, message) {
+        return [
+            `Client assets were not extracted for "${envName}".`,
+            'NocoBase will keep starting, but versioned client files for CDN or external distribution may be stale or missing.',
+            `Details: ${message}`,
+        ].join('\n');
+    }
+    async ensureManagedAppRuntimeConfig(params) {
+        const savedEnv = await getEnv(params.envName, { scope: resolveDefaultConfigScope() });
+        const savedConfig = savedEnv?.config;
+        params.appResults.appKey = Install.resolveManagedAppKey(params.appResults.appKey ?? savedConfig?.appKey);
+        params.appResults.timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone ?? savedConfig?.timezone);
     }
     static async validateAppPort(value, values) {
         const formatError = validateTcpPort(value);
@@ -916,7 +1014,7 @@ export default class Install extends Command {
         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 appRootPath = resolveConfiguredSourcePathValue(values, envName);
         const dockerNetworkName = await Install.resolveResumeDockerNetworkName();
         const dockerContainerPrefix = await Install.resolveResumeDockerContainerPrefix();
         return {
@@ -987,9 +1085,12 @@ export default class Install extends Command {
         const envName = String(env.name ?? '').trim();
         const config = env.config ?? {};
         const source = Install.toOptionalPromptString(config.source);
+        const appPath = Install.toOptionalPromptString(config.appPath) ?? inferConfiguredAppPathFromLegacyConfig(config);
         const appRootPath = Install.toOptionalPromptString(config.appRootPath);
         const appPort = Install.toOptionalPromptString(config.appPort);
         const storagePath = Install.toOptionalPromptString(config.storagePath);
+        const appPublicPath = Install.toOptionalPromptString(config.appPublicPath);
+        const apiBaseUrl = Install.toOptionalPromptString(config.apiBaseUrl);
         const downloadVersion = Install.toOptionalPromptString(config.downloadVersion);
         const dockerRegistry = Install.toOptionalPromptString(config.dockerRegistry);
         const dockerPlatform = Install.toOptionalPromptString(config.dockerPlatform);
@@ -1012,9 +1113,11 @@ export default class Install extends Command {
         const auth = config.auth;
         const savedAuthType = Install.toOptionalPromptString(config.authType) ?? Install.toOptionalPromptString(auth?.type);
         const appPreset = {
+            ...(appPath ? { appPath } : {}),
             ...(appRootPath ? { appRootPath } : {}),
             ...(appPort ? { appPort } : {}),
             ...(storagePath ? { storagePath } : {}),
+            ...(appPublicPath ? { appPublicPath } : {}),
         };
         const downloadPreset = {
             ...(source ? { source } : {}),
@@ -1052,6 +1155,9 @@ export default class Install extends Command {
             ...(rootNickname ? { rootNickname } : {}),
         };
         const envAddPreset = {};
+        if (apiBaseUrl) {
+            envAddPreset.apiBaseUrl = apiBaseUrl;
+        }
         if (savedAuthType === 'token') {
             envAddPreset.authType = 'token';
             if (Install.toOptionalPromptString(auth.accessToken)) {
@@ -1112,7 +1218,7 @@ export default class Install extends Command {
                 throw new Error([
                     `Cannot continue setup for "${env.name}" in non-interactive resume mode yet.`,
                     `These setup-only flags are not saved in the env config: ${missingFlags.join(', ')}`,
-                    `Run \`nb init --env ${env.name} --resume\` without \`--yes\`, or pass those flags again.`,
+                    `Run \`nb init --ui --env ${env.name} --resume\` without \`--yes\`, or pass those flags again.`,
                 ].join('\n'));
             }
         }
@@ -1133,6 +1239,9 @@ export default class Install extends Command {
     static async buildAppPromptInitialValues(params) {
         const initialValues = {};
         const envName = params.envName ?? DEFAULT_INSTALL_ENV_NAME;
+        if (params.flags['app-path'] === undefined && params.flags['app-root-path'] === undefined) {
+            initialValues.appPath = defaultInstallAppPath(envName);
+        }
         if (params.flags['app-root-path'] === undefined) {
             initialValues.appRootPath = defaultInstallAppRootPath(envName);
         }
@@ -1176,7 +1285,7 @@ export default class Install extends Command {
      * output directory with app settings, while Docker registry defaults follow the CLI locale.
      */
     static buildDownloadPromptOptionsForInstall(appResults, envName) {
-        const appRoot = String(appResults.appRootPath ?? '').trim() || defaultInstallAppRootPath(envName);
+        const appRoot = resolveConfiguredSourcePathValue(appResults, envName);
         const lang = String(appResults.lang ?? DEFAULT_INSTALL_LANG).trim() || DEFAULT_INSTALL_LANG;
         const initialValues = {
             lang,
@@ -1207,7 +1316,7 @@ export default class Install extends Command {
      */
     static buildDownloadPresetValuesForInstall(flags, appResults, envName, yes, argv = process.argv.slice(2)) {
         const preset = {};
-        const appRoot = String(appResults.appRootPath ?? '').trim() || defaultInstallAppRootPath(envName);
+        const appRoot = resolveConfiguredSourcePathValue(appResults, envName);
         const lang = String(appResults.lang ?? DEFAULT_INSTALL_LANG).trim() || DEFAULT_INSTALL_LANG;
         preset.lang = lang;
         if (flags.source !== undefined && String(flags.source).trim() !== '') {
@@ -1338,7 +1447,8 @@ export default class Install extends Command {
             : dbHostInput && dbHostInput !== DEFAULT_INSTALL_DB_HOST && dbHostInput !== 'localhost'
                 ? dbHostInput
                 : containerName;
-        const storagePath = resolveConfiguredEnvPath(params.storagePath) ?? resolveEnvRelativePath(defaultInstallStoragePath(params.envName));
+        const storagePath = resolveConfiguredEnvPath(params.storagePath) ??
+            resolveEnvRelativePath(resolveConfiguredStoragePathValue({ appPath: params.appPath, storagePath: params.storagePath }, params.envName));
         if (dbDialect === 'postgres') {
             const image = String(params.builtinDbImage ?? '').trim() || defaultBuiltinDbImageForDialect(dbDialect);
             const dataDir = path.resolve(storagePath, 'db', 'postgres');
@@ -1529,6 +1639,7 @@ export default class Install extends Command {
         if (this.ensuredDockerNetworks.has(name)) {
             return;
         }
+        await ensureDockerDaemonRunning('prepare Docker resources for this environment');
         printVerbose(`Checking Docker network: ${name}`);
         const exists = await commandSucceeds('docker', ['network', 'inspect', name]);
         if (exists) {
@@ -1607,12 +1718,13 @@ export default class Install extends Command {
         });
     }
     async startBuiltinDb(params) {
-        const storagePath = String(params.appResults.storagePath ?? '').trim() || defaultInstallStoragePath(params.envName);
+        const storagePath = resolveConfiguredStoragePathValue(params.appResults, params.envName);
         const plan = Install.buildBuiltinDbPlan({
             envName: params.envName,
             workspaceName: params.workspaceName,
             dockerNetworkName: params.dockerNetworkName,
             dockerContainerPrefix: params.dockerContainerPrefix,
+            appPath: params.appResults.appPath,
             storagePath,
             source: params.downloadResults.source,
             dbDialect: params.dbResults.dbDialect,
@@ -1653,7 +1765,9 @@ export default class Install extends Command {
             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 configuredStoragePath = resolveConfiguredStoragePathValue(params.appResults, params.envName);
+        const storagePath = resolveConfiguredEnvPath(configuredStoragePath) ??
+            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() ||
@@ -1664,8 +1778,10 @@ export default class Install extends Command {
         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 extractClientAssets = resolveExtractClientAssetsDefaultEnabled(process.env.NOCOBASE_EXTRACT_CLIENT_ASSETS);
+        const appKey = Install.resolveManagedAppKey(params.appResults.appKey);
+        const appPublicPath = Install.toOptionalPromptString(params.appResults.appPublicPath);
+        const timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone);
         const containerName = Install.buildDockerAppContainerName(params.envName, params.dockerContainerPrefix ?? params.workspaceName);
         const configuredEnvFile = String(params.appResults.envFile ?? '').trim();
         const envFile = await resolveDockerEnvFileArg(params.envName, configuredEnvFile ? { envFile: configuredEnvFile } : undefined);
@@ -1692,9 +1808,11 @@ export default class Install extends Command {
             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`);
+        pushOptionalEnvArg(args, 'APP_PUBLIC_PATH', appPublicPath);
         pushOptionalEnvArg(args, 'DB_SCHEMA', dbSchema);
         pushOptionalEnvArg(args, 'DB_TABLE_PREFIX', dbTablePrefix);
         pushOptionalEnvArg(args, 'DB_UNDERSCORED', dbUnderscored);
+        pushOptionalEnvArg(args, 'NOCOBASE_EXTRACT_CLIENT_ASSETS', extractClientAssets);
         args.push(imageRef);
         return {
             source: 'docker',
@@ -1801,17 +1919,15 @@ export default class Install extends Command {
             return projectRoot;
         }
         const outputDir = String(params.downloadResults.outputDir ?? '').trim() ||
-            String(params.appResults.appRootPath ?? '').trim() ||
-            defaultInstallAppRootPath(params.envName);
+            resolveConfiguredSourcePathValue(params.appResults, 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));
+            resolveConfiguredSourcePathValue(params.appResults, params.envName));
     }
     static buildSkipDownloadValues(envName, appResults) {
-        const appRoot = String(appResults.appRootPath ?? '').trim() || defaultInstallAppRootPath(envName);
+        const appRoot = resolveConfiguredSourcePathValue(appResults, envName);
         return {
             outputDir: appRoot,
             replace: false,
@@ -1884,12 +2000,12 @@ export default class Install extends Command {
         return downloadedProjectRoot;
     }
     static buildLocalAppEnvVars(params) {
-        const configuredStoragePath = String(params.appResults.storagePath ?? '').trim() || defaultInstallStoragePath(params.envName);
+        const configuredStoragePath = resolveConfiguredStoragePathValue(params.appResults, 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 appKey = Install.resolveManagedAppKey(params.appResults.appKey);
+        const timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone);
         const env = {
             STORAGE_PATH: storagePath,
             APP_PORT: String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT,
@@ -1907,6 +2023,7 @@ export default class Install extends Command {
                 rootResults: params.rootResults,
             }),
         };
+        setOptionalEnvVar(env, 'APP_PUBLIC_PATH', Install.toOptionalPromptString(params.appResults.appPublicPath));
         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));
@@ -1932,6 +2049,24 @@ export default class Install extends Command {
             const message = error instanceof Error ? error.message : String(error);
             this.logDetail(`Skipped local process cleanup before start: ${message}`);
         }
+        this.logDetail(`Running local postinstall in ${params.projectRoot}`);
+        await runNocoBaseCommand(['postinstall'], {
+            cwd: params.projectRoot,
+            env,
+            stdio: params.commandStdio ?? 'ignore',
+        });
+        this.logDetail(`Extracting local client assets in ${params.projectRoot}`);
+        try {
+            await runNocoBaseCommand(['client:extract'], {
+                cwd: params.projectRoot,
+                env,
+                stdio: params.commandStdio ?? 'ignore',
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            printWarning(Install.formatLocalClientExtractWarning(params.envName, message));
+        }
         this.logDetail(`Starting local NocoBase app from ${params.projectRoot}`);
         await runNocoBaseCommand(args, {
             cwd: params.projectRoot,
@@ -1951,8 +2086,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`;
+        return (String(params.envAddResults.apiBaseUrl ?? '').trim() ||
+            buildInstallApiBaseUrl(params.appResults, params.defaultApiHost));
     }
     static buildHealthCheckUrl(apiBaseUrl) {
         return `${apiBaseUrl.replace(/\/+$/, '')}/__health_check`;
@@ -2010,35 +2145,44 @@ export default class Install extends Command {
         let lastMessage = 'No response yet';
         let lastLoggedStatus = '';
         printInfo('Waiting for NocoBase to become ready...');
-        while (Date.now() - startedAt < timeoutMs) {
-            const result = await Install.requestAppHealthCheck({
-                healthCheckUrl,
-                fetchImpl,
-                requestTimeoutMs,
-            });
-            if (result.ok) {
-                return;
-            }
-            lastMessage = result.message;
-            const elapsedSeconds = Math.max(1, Math.floor((Date.now() - startedAt) / 1000));
-            const statusLine = `Waiting for NocoBase to become ready... (${elapsedSeconds}s elapsed, last status: ${Install.formatHealthCheckMessage(lastMessage)})`;
-            if (statusLine !== lastLoggedStatus) {
-                printInfo(statusLine);
-                lastLoggedStatus = statusLine;
-            }
-            const remainingMs = timeoutMs - (Date.now() - startedAt);
-            if (remainingMs <= 0) {
-                break;
+        const dockerLogFollower = options?.verbose && options.containerName ? startDockerLogFollower(options.containerName) : undefined;
+        try {
+            while (Date.now() - startedAt < timeoutMs) {
+                const result = await Install.requestAppHealthCheck({
+                    healthCheckUrl,
+                    fetchImpl,
+                    requestTimeoutMs,
+                });
+                if (result.ok) {
+                    return;
+                }
+                lastMessage = result.message;
+                const elapsedSeconds = Math.max(1, Math.floor((Date.now() - startedAt) / 1000));
+                const statusLine = `Waiting for NocoBase to become ready... (${elapsedSeconds}s elapsed, last status: ${Install.formatHealthCheckMessage(lastMessage)})`;
+                if (statusLine !== lastLoggedStatus) {
+                    printInfo(statusLine);
+                    lastLoggedStatus = statusLine;
+                }
+                const remainingMs = timeoutMs - (Date.now() - startedAt);
+                if (remainingMs <= 0) {
+                    break;
+                }
+                await Install.sleep(Math.min(intervalMs, remainingMs));
             }
-            await Install.sleep(Math.min(intervalMs, remainingMs));
+            const logHint = options?.containerName
+                ? ` You can inspect startup logs with: docker logs ${options.containerName}`
+                : '';
+            throw new Error(`The application did not become ready in time. Expected \`${healthCheckUrl}\` to respond with \`ok\`, but the last status was: ${Install.formatHealthCheckMessage(lastMessage)}.${logHint}`);
+        }
+        finally {
+            await dockerLogFollower?.stop();
         }
-        const logHint = options?.containerName
-            ? ` You can inspect startup logs with: docker logs ${options.containerName}`
-            : '';
-        throw new Error(`The application did not become ready in time. Expected \`${healthCheckUrl}\` to respond with \`ok\`, but the last status was: ${Install.formatHealthCheckMessage(lastMessage)}.${logHint}`);
     }
     async saveInstalledEnv(params) {
-        await upsertEnv(params.envName, Install.buildSavedEnvConfig(params), { scope: resolveDefaultConfigScope() });
+        const defaultApiHost = await resolveDefaultApiHost();
+        await upsertEnv(params.envName, Install.buildSavedEnvConfig(params, { defaultApiHost }), {
+            scope: resolveDefaultConfigScope(),
+        });
         await setCurrentEnv(params.envName, { scope: resolveDefaultConfigScope() });
     }
     async syncInstalledEnvConnection(params) {
@@ -2067,13 +2211,19 @@ export default class Install extends Command {
         }
         await this.config.runCommand('env:update', [params.envName]);
     }
-    static buildSavedEnvConfig(params) {
+    static buildSavedEnvConfig(params, options = {}) {
+        const appPath = resolveConfiguredAppPathValue(params.appResults);
+        const appRootPath = Install.toOptionalPromptString(params.appResults.appRootPath);
+        const storagePath = Install.toOptionalPromptString(params.appResults.storagePath);
+        const appPublicPath = Install.toOptionalPromptString(params.appResults.appPublicPath);
+        const derivedAppRootPath = appPath ? deriveConfiguredSourcePath(appPath) : undefined;
+        const derivedStoragePath = appPath ? deriveConfiguredStoragePath(appPath) : undefined;
         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,
+            defaultApiHost: options.defaultApiHost,
         });
         const authType = String(params.envAddResults.authType ?? 'oauth').trim() || 'oauth';
         const authUsername = authType === 'basic' ? String(params.envAddResults.username ?? params.rootResults.rootUsername ?? '').trim() : '';
@@ -2091,9 +2241,11 @@ export default class Install extends Command {
             devDependencies: downloadResultsValue(params.downloadResults, 'devDependencies'),
             build: downloadResultsValue(params.downloadResults, 'build'),
             buildDts: downloadResultsValue(params.downloadResults, 'buildDts'),
-            appRootPath: params.appResults.appRootPath,
+            ...(appPath ? { appPath } : {}),
+            ...(appRootPath && !areConfiguredPathsEquivalent(appRootPath, derivedAppRootPath) ? { appRootPath } : {}),
             appPort,
-            storagePath,
+            ...(storagePath && !areConfiguredPathsEquivalent(storagePath, derivedStoragePath) ? { storagePath } : {}),
+            ...(appPublicPath ? { appPublicPath } : {}),
             ...(envFile ? { envFile } : {}),
             appKey: params.appResults.appKey,
             timezone: params.appResults.timeZone,
@@ -2116,6 +2268,7 @@ export default class Install extends Command {
     }
     async collectPromptResults(parsed, yes) {
         const commandArgv = this.argv ?? process.argv.slice(2);
+        const defaultApiHost = await resolveDefaultApiHost();
         const resumePreset = await this.resolveResumePresetValues(parsed, yes);
         const envPreset = {
             ...(resumePreset?.envPreset ?? {}),
@@ -2141,6 +2294,7 @@ export default class Install extends Command {
                 envName,
                 flags: {
                     ...parsed,
+                    'app-path': parsed['app-path'] ?? Install.toOptionalPromptString(appPreset.appPath),
                     '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),
@@ -2210,7 +2364,7 @@ export default class Install extends Command {
         };
         const resolvedEnvAddAuthType = String(envAddPreset.authType ?? '').trim();
         const envAddInitialValues = {
-            apiBaseUrl: `http://127.0.0.1:${appResults.appPort ?? DEFAULT_INSTALL_APP_PORT}/api`,
+            apiBaseUrl: buildInstallApiBaseUrl(appResults, defaultApiHost),
             ...envAddResumePreset,
             ...(!parsed['skip-auth'] && resolvedEnvAddAuthType === 'basic'
                 ? {
@@ -2257,6 +2411,7 @@ export default class Install extends Command {
         const parsed = {
             ...flags,
         };
+        const defaultApiHost = await resolveDefaultApiHost();
         if (parsed['skip-auth'] && (parsed['access-token'] !== undefined || parsed.token !== undefined)) {
             this.error('--skip-auth cannot be used with --access-token or --token.');
         }
@@ -2273,6 +2428,10 @@ export default class Install extends Command {
         }
         const promptResults = await this.collectPromptResults(parsed, flags.yes);
         const { envName, appResults, downloadResults, dbResults, rootResults, envAddResults } = promptResults;
+        await this.ensureManagedAppRuntimeConfig({
+            envName,
+            appResults,
+        });
         const source = String(downloadResultsValue(downloadResults, 'source') ?? '').trim();
         const usesDockerResources = Boolean(dbResults.builtinDb) || source === 'docker';
         const dockerNetworkName = usesDockerResources
@@ -2390,10 +2549,17 @@ export default class Install extends Command {
             await this.waitForAppHealthCheck(Install.resolveApiBaseUrl({
                 appResults,
                 envAddResults,
+                defaultApiHost,
             }), {
                 containerName: dockerAppPlan?.containerName,
+                verbose: parsed.verbose,
+            });
+            const displayApiBaseUrl = Install.resolveApiBaseUrl({
+                appResults,
+                envAddResults,
+                defaultApiHost,
             });
-            printInfo(`NocoBase is ready at http://127.0.0.1:${dockerAppPlan?.appPort ?? localAppPlan?.appPort}`);
+            printInfo(`NocoBase is ready at ${formatInstallDisplayUrl(displayApiBaseUrl)}`);
         }
         if (dockerAppPlan || localAppPlan || builtinDbPlan) {
             await this.saveInstalledEnv({
@@ -2411,6 +2577,7 @@ export default class Install extends Command {
             appReady: Boolean(dockerAppPlan || localAppPlan),
             skipAuth: Boolean(parsed['skip-auth']),
         });
+        await clearEnvRootSetup(envName, { scope: resolveDefaultConfigScope() });
         if (!dockerAppPlan && !localAppPlan) {
             printInfo(`Install config for "${envName}" has been saved.`);
         }