@nocobase/cli 2.2.0-alpha.1 → 2.2.0-alpha.10

package/dist/commands/install.js

@@ -13,11 +13,11 @@ 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 { applyCliLocale, localeText, 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 { resolveDefaultApiHost, resolveDockerContainerPrefix, resolveDockerNetworkName } from '../lib/cli-config.js';
-import { DEFAULT_DOCKER_VERSION, resolveDockerImageRef } from "../lib/docker-image.js";
+import { defaultDockerContainerPrefix, defaultDockerNetworkName, managedAppLifecycleEnvVars, } from '../lib/app-runtime.js';
+import { getCliConfigValue, resolveDefaultApiHost, resolveDockerContainerPrefix, resolveDockerNetworkName, } from '../lib/cli-config.js';
+import { DEFAULT_DOCKER_VERSION, DEFAULT_NB_IMAGE_VARIANT, inferNbImageRegistryFromRepository, normalizeNbImageVariant, resolveBuiltinDbImage, resolveDockerImageContainerPort, resolveDockerImageRef, resolveOfficialDockerRegistry, } from "../lib/docker-image.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';
@@ -29,8 +29,9 @@ import { buildStoredEnvConfig } from '../lib/env-config.js';
 import { resolveDockerEnvFileArg } from "../lib/docker-env-file.js";
 import { startDockerLogFollower } from '../lib/docker-log-stream.js';
 import { buildInitAppEnvVarsFromConfig } from '../lib/managed-init-env.js';
+import { buildHookContext, persistHookScript, resolveHookScriptPath, runHookScriptHook, } from '../lib/hook-script.js';
 import { areConfiguredPathsEquivalent, deriveConfiguredSourcePath, deriveConfiguredStoragePath, inferConfiguredAppPathFromLegacyConfig, } from '../lib/env-paths.js';
-import Download, { defaultDockerRegistryForLang } from './download.js';
+import Download from './download.js';
 import EnvAdd from "./env/add.js";
 import { resolveAppUrlFromApiBaseUrl } from "./env/shared.js";
 const DEFAULT_INSTALL_ENV_NAME = 'local';
@@ -44,18 +45,6 @@ const DEFAULT_INSTALL_DB_PORTS = {
     mariadb: '3306',
     kingbase: '54321',
 };
-const DEFAULT_INSTALL_BUILTIN_DB_IMAGES = {
-    postgres: 'postgres:16',
-    mysql: 'mysql:8',
-    mariadb: 'mariadb:11',
-    kingbase: 'registry.cn-shanghai.aliyuncs.com/nocobase/kingbase:v009r001c001b0030_single_x86',
-};
-const DEFAULT_INSTALL_BUILTIN_DB_IMAGES_ZH_CN = {
-    postgres: 'registry.cn-shanghai.aliyuncs.com/nocobase/postgres:16',
-    mysql: 'registry.cn-shanghai.aliyuncs.com/nocobase/mysql:8',
-    mariadb: 'registry.cn-shanghai.aliyuncs.com/nocobase/mariadb:11',
-    kingbase: 'registry.cn-shanghai.aliyuncs.com/nocobase/kingbase:v009r001c001b0030_single_x86',
-};
 const DEFAULT_INSTALL_DB_DATABASE = 'nocobase';
 const DEFAULT_INSTALL_DB_USER = 'nocobase';
 const DEFAULT_INSTALL_DB_PASSWORD = 'nocobase';
@@ -64,6 +53,10 @@ 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';
+const DEFAULT_INSTALL_PORTAL_TYPE = 'no-code';
+const DEFAULT_INSTALL_PORTAL_NAME = 'admin';
+const DEFAULT_INSTALL_PORTAL_TEMPLATE = '@nocobase/portal-template-default';
+const INSTALL_PORTAL_TYPES = ['no-code', 'ai'];
 function toOptionalPromptString(value) {
     const text = String(value ?? '').trim();
     return text || undefined;
@@ -178,22 +171,26 @@ function downloadVersionPromptValue(version) {
 }
 function supportsBuiltinDbDialect(value) {
     const dialect = String(value ?? '').trim();
-    return Object.prototype.hasOwnProperty.call(DEFAULT_INSTALL_BUILTIN_DB_IMAGES, dialect);
+    return INSTALL_DB_DIALECTS.includes(dialect);
 }
 export function defaultDbPortForDialect(value) {
     const dialect = String(value ?? 'postgres').trim();
     return DEFAULT_INSTALL_DB_PORTS[isInstallDbDialect(dialect) ? dialect : 'postgres'];
 }
-function defaultBuiltinDbImageForDialect(value) {
+function defaultBuiltinDbImageForDialect(value, options) {
     const dialect = String(value ?? 'postgres').trim();
-    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 resolveBuiltinDbImage(dialect, { registry: options?.registry });
 }
 function defaultDbDatabaseForDialect(value) {
     return String(value ?? '').trim() === 'kingbase' ? 'kingbase' : DEFAULT_INSTALL_DB_DATABASE;
 }
+function isAiMode(values) {
+    return String(values.portalType ?? DEFAULT_INSTALL_PORTAL_TYPE).trim() === 'ai';
+}
+function supportsDbSchemaPrompt(value) {
+    const dialect = String(value ?? '').trim();
+    return dialect === 'postgres' || dialect === 'kingbase';
+}
 function defaultDbHostForBuiltinDb(values) {
     return values.builtinDb ? DEFAULT_INSTALL_BUILTIN_DB_HOST : DEFAULT_INSTALL_DB_HOST;
 }
@@ -414,6 +411,16 @@ export default class Install extends Command {
         'app-public-path': Flags.string({
             description: 'Public path for the local app, for example / or /console/',
         }),
+        'portal-type': Flags.string({
+            description: 'Initial portal type for the installed app',
+            options: [...INSTALL_PORTAL_TYPES],
+        }),
+        'portal-name': Flags.string({
+            description: 'Initial portal name',
+        }),
+        'portal-template': Flags.string({
+            description: 'Initial portal template npm package or local path when --portal-type ai is used',
+        }),
         'root-username': Flags.string({
             description: 'Initial admin username for the installed app',
             required: false,
@@ -472,7 +479,10 @@ export default class Install extends Command {
             description: 'Skip the download step and reuse an existing local app directory or Docker image',
             default: false,
         }),
-        ...omitKeys(Download.flags, ['yes']),
+        'hook-script': Flags.string({
+            description: 'Hook module copied to <appPath>/.nb/hooks.mjs and run before npm/git dependency installation.',
+        }),
+        ...omitKeys(Download.flags, ['yes', 'hook-script']),
     };
     /** Environment name only: run before {@link Install.prompts} (see `run`). */
     static envPrompts = {
@@ -520,6 +530,41 @@ export default class Install extends Command {
                 yesInitialValue: '/',
                 validate: validateAppPublicPath,
             },
+            portalType: {
+                type: 'select',
+                message: installText('prompts.portalType.message'),
+                options: [
+                    {
+                        value: 'no-code',
+                        label: installText('prompts.portalType.noCodeLabel'),
+                        hint: installText('prompts.portalType.noCodeHint'),
+                    },
+                    {
+                        value: 'ai',
+                        label: installText('prompts.portalType.aiLabel'),
+                        hint: installText('prompts.portalType.aiHint'),
+                    },
+                ],
+                initialValue: DEFAULT_INSTALL_PORTAL_TYPE,
+                yesInitialValue: DEFAULT_INSTALL_PORTAL_TYPE,
+                required: true,
+            },
+            portalName: {
+                type: 'text',
+                message: installText('prompts.portalName.message'),
+                placeholder: DEFAULT_INSTALL_PORTAL_NAME,
+                initialValue: DEFAULT_INSTALL_PORTAL_NAME,
+                yesInitialValue: DEFAULT_INSTALL_PORTAL_NAME,
+                required: true,
+            },
+            portalTemplate: {
+                type: 'text',
+                message: installText('prompts.portalTemplate.message'),
+                placeholder: DEFAULT_INSTALL_PORTAL_TEMPLATE,
+                yesInitialValue: DEFAULT_INSTALL_PORTAL_TEMPLATE,
+                hidden: (values) => !isAiMode(values),
+                required: true,
+            },
         };
     }
     static dbPrompts = {
@@ -547,7 +592,9 @@ export default class Install extends Command {
             type: 'text',
             message: installText('prompts.builtinDbImage.message'),
             placeholder: installText('prompts.builtinDbImage.placeholder'),
-            initialValue: (values) => defaultBuiltinDbImageForDialect(values.dbDialect),
+            initialValue: (values) => defaultBuiltinDbImageForDialect(values.dbDialect, {
+                registry: String(values.builtinDbImageRegistry ?? '').trim() || undefined,
+            }),
             hidden: (values) => !values.builtinDb || !supportsBuiltinDbDialect(values.dbDialect),
             required: true,
         },
@@ -597,7 +644,7 @@ export default class Install extends Command {
             type: 'text',
             message: installText('prompts.dbSchema.message'),
             placeholder: installText('prompts.dbSchema.placeholder'),
-            hidden: (values) => String(values.dbDialect ?? '').trim() !== 'postgres',
+            hidden: (values) => !supportsDbSchemaPrompt(values.dbDialect),
         },
         dbTablePrefix: {
             type: 'text',
@@ -777,6 +824,24 @@ export default class Install extends Command {
                 preset.appPublicPath = v;
             }
         }
+        if (flags['portal-type'] !== undefined) {
+            const v = String(flags['portal-type'] ?? '').trim();
+            if (v) {
+                preset.portalType = v;
+            }
+        }
+        if (flags['portal-name'] !== undefined) {
+            const v = String(flags['portal-name'] ?? '').trim();
+            if (v) {
+                preset.portalName = v;
+            }
+        }
+        if (flags['portal-template'] !== undefined) {
+            const v = String(flags['portal-template'] ?? '').trim();
+            if (v) {
+                preset.portalTemplate = v;
+            }
+        }
         if (flags['root-username'] !== undefined) {
             preset.rootUsername = String(flags['root-username'] ?? '').trim();
         }
@@ -868,6 +933,9 @@ export default class Install extends Command {
             'appPort',
             'storagePath',
             'appPublicPath',
+            'portalType',
+            'portalName',
+            'portalTemplate',
         ]);
     }
     static buildDbPresetValuesFromFlags(flags, argv = process.argv.slice(2)) {
@@ -1095,6 +1163,7 @@ export default class Install extends Command {
         const appPort = Install.toOptionalPromptString(config.appPort);
         const storagePath = Install.toOptionalPromptString(config.storagePath);
         const appPublicPath = Install.toOptionalPromptString(config.appPublicPath);
+        const hookScript = Install.toOptionalPromptString(config.hookScript);
         const apiBaseUrl = Install.toOptionalPromptString(config.apiBaseUrl);
         const downloadVersion = Install.toOptionalPromptString(config.downloadVersion);
         const dockerRegistry = Install.toOptionalPromptString(config.dockerRegistry);
@@ -1116,6 +1185,9 @@ export default class Install extends Command {
         const rootPassword = Install.toOptionalPromptString(config.rootPassword);
         const rootNickname = Install.toOptionalPromptString(config.rootNickname);
         const lang = Install.toOptionalPromptString(config.lang);
+        const portalType = Install.toOptionalPromptString(config.portalType);
+        const portalName = Install.toOptionalPromptString(config.portalName);
+        const portalTemplate = Install.toOptionalPromptString(config.portalTemplate);
         const auth = config.auth;
         const savedAuthType = Install.toOptionalPromptString(config.authType) ?? Install.toOptionalPromptString(auth?.type);
         const appPreset = {
@@ -1125,6 +1197,10 @@ export default class Install extends Command {
             ...(appPort ? { appPort } : {}),
             ...(storagePath ? { storagePath } : {}),
             ...(appPublicPath ? { appPublicPath } : {}),
+            ...(portalType ? { portalType } : {}),
+            ...(portalName ? { portalName } : {}),
+            ...(portalTemplate ? { portalTemplate } : {}),
+            ...(hookScript ? { hookScript } : {}),
         };
         const downloadPreset = {
             ...(source ? { source } : {}),
@@ -1266,6 +1342,12 @@ export default class Install extends Command {
                 warn: params.warnOnPortFallback ?? true,
             });
         }
+        if (params.flags['portal-template'] === undefined) {
+            const defaultPortalTemplate = Install.toOptionalPromptString(await getCliConfigValue('default-portal-template'));
+            if (defaultPortalTemplate) {
+                initialValues.portalTemplate = defaultPortalTemplate;
+            }
+        }
         return initialValues;
     }
     static shouldPublishBuiltinDbPortForValues(values) {
@@ -1273,19 +1355,25 @@ export default class Install extends Command {
         return builtinDb && Install.shouldPublishBuiltinDbPort(values.source);
     }
     static async buildDbPromptInitialValues(params) {
-        if (params.flags['db-port'] !== undefined) {
-            return {};
-        }
+        const configuredRegistry = await getCliConfigValue('nb-image-registry');
         const values = {
             ...params.downloadResults,
             ...params.dbPreset,
         };
+        const dockerRegistry = String(values.dockerRegistry ?? '').trim() || resolveOfficialDockerRegistry(configuredRegistry);
+        const dialect = String(values.dbDialect ?? 'postgres').trim() || 'postgres';
+        const initialValues = values.builtinDb !== false && params.dbPreset.builtinDbImage === undefined
+            ? { builtinDbImage: defaultBuiltinDbImageForDialect(dialect, { registry: dockerRegistry }) }
+            : {};
+        if (params.flags['db-port'] !== undefined) {
+            return initialValues;
+        }
         if (!Install.shouldPublishBuiltinDbPortForValues(values)) {
-            return {};
+            return initialValues;
         }
-        const dialect = String(values.dbDialect ?? 'postgres').trim() || 'postgres';
         const defaultPort = defaultDbPortForDialect(dialect);
         return {
+            ...initialValues,
             dbPort: await Install.resolveAvailableDefaultPort(defaultPort, {
                 label: `Default ${dialect} port`,
                 warn: params.warnOnPortFallback ?? true,
@@ -1296,12 +1384,13 @@ export default class Install extends Command {
      * When install runs {@link Download.prompts} after app prompts, align the download
      * output directory with app settings, while Docker registry defaults follow the CLI locale.
      */
-    static buildDownloadPromptOptionsForInstall(appResults, envName) {
+    static async buildDownloadPromptOptionsForInstall(appResults, envName) {
         const appRoot = resolveConfiguredSourcePathValue(appResults, envName);
         const lang = String(appResults.lang ?? DEFAULT_INSTALL_LANG).trim() || DEFAULT_INSTALL_LANG;
+        const dockerRegistry = resolveOfficialDockerRegistry(await getCliConfigValue('nb-image-registry'));
         const initialValues = {
             lang,
-            dockerRegistry: defaultDockerRegistryForLang(process.env.NB_LOCALE),
+            dockerRegistry,
             outputDir: appRoot,
         };
         const values = {
@@ -1426,14 +1515,17 @@ export default class Install extends Command {
     static buildDockerAppContainerName(envName, containerPrefix) {
         return Install.sanitizeDockerResourceName(`${Install.buildBuiltinDbContainerPrefix(containerPrefix)}-${envName}-app`);
     }
-    static buildInitAppEnvVars(params) {
+    static buildInitAppEnvVars(params, options = {}) {
         return buildInitAppEnvVarsFromConfig({
             lang: String(params.appResults.lang ?? ''),
             rootUsername: String(params.rootResults.rootUsername ?? ''),
             rootEmail: String(params.rootResults.rootEmail ?? ''),
             rootPassword: String(params.rootResults.rootPassword ?? ''),
             rootNickname: String(params.rootResults.rootNickname ?? ''),
-        });
+            portalType: String(params.appResults.portalType ?? ''),
+            portalName: String(params.appResults.portalName ?? ''),
+            portalTemplate: String(params.appResults.portalTemplate ?? ''),
+        }, options);
     }
     static shouldPublishBuiltinDbPort(source) {
         return String(source ?? '').trim() !== 'docker';
@@ -1462,8 +1554,6 @@ export default class Install extends Command {
                 '-d',
                 '--name',
                 containerName,
-                '--restart',
-                'always',
                 '--network',
                 networkName,
                 '-e',
@@ -1506,8 +1596,6 @@ export default class Install extends Command {
                 '-d',
                 '--name',
                 containerName,
-                '--restart',
-                'always',
                 '--network',
                 networkName,
                 '-e',
@@ -1552,8 +1640,6 @@ export default class Install extends Command {
                 '-d',
                 '--name',
                 containerName,
-                '--restart',
-                'always',
                 '--network',
                 networkName,
                 '-e',
@@ -1598,8 +1684,6 @@ export default class Install extends Command {
                 '-d',
                 '--name',
                 containerName,
-                '--restart',
-                'always',
                 '--network',
                 networkName,
                 '--platform',
@@ -1762,12 +1846,15 @@ export default class Install extends Command {
         return plan;
     }
     static async buildDockerAppPlan(params) {
+        const configuredRegistry = await getCliConfigValue('nb-image-registry');
+        const configuredVariant = normalizeNbImageVariant(await getCliConfigValue('nb-image-variant')) ?? DEFAULT_NB_IMAGE_VARIANT;
         const dockerRegistry = String(downloadResultsValue(params.downloadResults, 'dockerRegistry') ?? '').trim() ||
-            defaultDockerRegistryForLang(process.env.NB_LOCALE);
+            resolveOfficialDockerRegistry(configuredRegistry);
         const version = String(downloadResultsValue(params.downloadResults, 'version') ?? '').trim() || DEFAULT_DOCKER_VERSION;
         const imageRef = resolveDockerImageRef(dockerRegistry, version, {
-            defaultRegistry: defaultDockerRegistryForLang(process.env.NB_LOCALE),
+            defaultRegistry: resolveOfficialDockerRegistry(configuredRegistry),
             defaultVersion: DEFAULT_DOCKER_VERSION,
+            variant: inferNbImageRegistryFromRepository(dockerRegistry) ? configuredVariant : undefined,
         });
         const appPort = String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT;
         const configuredStoragePath = resolveConfiguredStoragePathValue(params.appResults, params.envName);
@@ -1794,17 +1881,16 @@ export default class Install extends Command {
             appResults: params.appResults,
             rootResults: params.rootResults,
         });
+        const containerPort = resolveDockerImageContainerPort(imageRef);
         const args = [
             'run',
             '-d',
             '--name',
             containerName,
-            '--restart',
-            'always',
             '--network',
             params.networkName,
             '-p',
-            `${appPort}:80`,
+            `${appPort}:${containerPort}`,
         ];
         if (envFile) {
             args.push('--env-file', envFile);
@@ -1916,6 +2002,12 @@ export default class Install extends Command {
         if (results.buildDts) {
             argv.push('--build-dts');
         }
+        Install.pushDownloadArgIfValue(argv, '--hook-script', results.hookScript);
+        Install.pushDownloadArgIfValue(argv, '--hook-phase', results.hookPhase);
+        Install.pushDownloadArgIfValue(argv, '--hook-command', results.hookCommand);
+        Install.pushDownloadArgIfValue(argv, '--hook-env-name', results.hookEnvName);
+        Install.pushDownloadArgIfValue(argv, '--hook-app-path', results.hookAppPath);
+        Install.pushDownloadArgIfValue(argv, '--hook-storage-path', results.hookStoragePath);
         return argv;
     }
     static resolveLocalProjectRoot(params) {
@@ -1942,6 +2034,40 @@ export default class Install extends Command {
             buildDts: false,
         };
     }
+    static resolveAbsoluteAppPath(envName, appResults) {
+        const configuredAppPath = resolveConfiguredAppPathValue(appResults) ?? defaultInstallAppPath(envName);
+        return resolveConfiguredEnvPath(configuredAppPath) ?? resolveEnvRelativePath(defaultInstallAppPath(envName));
+    }
+    static resolveAbsoluteStoragePath(envName, appResults) {
+        const configuredStoragePath = resolveConfiguredStoragePathValue(appResults, envName);
+        return (resolveConfiguredEnvPath(configuredStoragePath) ?? resolveEnvRelativePath(defaultInstallStoragePath(envName)));
+    }
+    async prepareHookScriptForInstall(params) {
+        const appPath = Install.resolveAbsoluteAppPath(params.envName, params.appResults);
+        const storagePath = Install.resolveAbsoluteStoragePath(params.envName, params.appResults);
+        const inputHookScript = Install.toOptionalPromptString(params.hookScript);
+        if (inputHookScript) {
+            params.appResults.hookScript = await persistHookScript({
+                sourcePath: inputHookScript,
+                appPath,
+            });
+            printInfo(`Saved hook script to ${path.join(appPath, String(params.appResults.hookScript))}.`);
+        }
+        const savedHookScript = Install.toOptionalPromptString(params.appResults.hookScript);
+        const hookScriptPath = resolveHookScriptPath({
+            appPath,
+            hookScript: savedHookScript,
+        });
+        if (!hookScriptPath) {
+            return;
+        }
+        params.downloadResults.hookScript = hookScriptPath;
+        params.downloadResults.hookPhase = 'init';
+        params.downloadResults.hookCommand = 'init';
+        params.downloadResults.hookEnvName = params.envName;
+        params.downloadResults.hookAppPath = appPath;
+        params.downloadResults.hookStoragePath = storagePath;
+    }
     commandStdio(verbose) {
         return verbose ? 'inherit' : 'ignore';
     }
@@ -1954,12 +2080,15 @@ export default class Install extends Command {
     }
     async ensureSkippedDownloadInputsReady(params) {
         if (params.source === 'docker') {
+            const configuredRegistry = await getCliConfigValue('nb-image-registry');
+            const configuredVariant = normalizeNbImageVariant(await getCliConfigValue('nb-image-variant')) ?? DEFAULT_NB_IMAGE_VARIANT;
             const dockerRegistry = String(downloadResultsValue(params.downloadResults, 'dockerRegistry') ?? '').trim() ||
-                defaultDockerRegistryForLang(process.env.NB_LOCALE);
+                resolveOfficialDockerRegistry(configuredRegistry);
             const version = String(downloadResultsValue(params.downloadResults, 'version') ?? '').trim() || DEFAULT_DOCKER_VERSION;
             const imageRef = resolveDockerImageRef(dockerRegistry, version, {
-                defaultRegistry: defaultDockerRegistryForLang(process.env.NB_LOCALE),
+                defaultRegistry: resolveOfficialDockerRegistry(configuredRegistry),
                 defaultVersion: DEFAULT_DOCKER_VERSION,
+                variant: inferNbImageRegistryFromRepository(dockerRegistry) ? configuredVariant : undefined,
             });
             const imageExists = await commandSucceeds('docker', ['image', 'inspect', imageRef]);
             if (!imageExists) {
@@ -2011,7 +2140,9 @@ export default class Install extends Command {
         const dbDialect = String(params.dbResults.dbDialect ?? 'postgres').trim() || 'postgres';
         const appKey = Install.resolveManagedAppKey(params.appResults.appKey);
         const timeZone = Install.resolveManagedTimeZone(params.appResults.timeZone);
+        const lifecycleEnvVars = managedAppLifecycleEnvVars();
         const env = {
+            ...lifecycleEnvVars,
             STORAGE_PATH: storagePath,
             APP_PORT: String(params.appResults.appPort ?? DEFAULT_INSTALL_APP_PORT).trim() || DEFAULT_INSTALL_APP_PORT,
             APP_KEY: appKey,
@@ -2216,11 +2347,59 @@ export default class Install extends Command {
         }
         await this.config.runCommand('env:update', [params.envName]);
     }
+    buildAppStartArgv(params) {
+        const argv = ['--env', params.envName, '--yes', '--no-sync-licensed-plugins', '--hook-command', 'init'];
+        if (params.verbose) {
+            argv.push('--verbose');
+        }
+        return argv;
+    }
+    async runInstallHookIfNeeded(params) {
+        const appPath = Install.resolveAbsoluteAppPath(params.envName, params.appResults);
+        const savedHookScript = Install.toOptionalPromptString(params.appResults.hookScript);
+        const hookScriptPath = resolveHookScriptPath({
+            appPath,
+            hookScript: savedHookScript,
+        });
+        if (!hookScriptPath) {
+            return;
+        }
+        const storagePath = Install.resolveAbsoluteStoragePath(params.envName, params.appResults);
+        const sourcePath = params.projectRoot ??
+            resolveConfiguredEnvPath(resolveConfiguredSourcePathValue(params.appResults, params.envName)) ??
+            path.join(appPath, 'source');
+        const context = buildHookContext({
+            phase: 'init',
+            command: 'init',
+            envName: params.envName,
+            source: params.source,
+            version: downloadResultsValue(params.downloadResults, 'version'),
+            appPath,
+            sourcePath,
+            storagePath,
+            hookScript: savedHookScript,
+            envConfig: Install.buildSavedEnvConfig(params, {
+                defaultApiHost: params.defaultApiHost,
+            }),
+        });
+        if (!context) {
+            return;
+        }
+        this.log(`Running hook ${params.hookName}: ${hookScriptPath}`);
+        await runHookScriptHook({
+            hookScriptPath,
+            hookName: params.hookName,
+            context,
+        });
+    }
     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 portalType = Install.toOptionalPromptString(params.appResults.portalType);
+        const portalName = Install.toOptionalPromptString(params.appResults.portalName);
+        const portalTemplate = Install.toOptionalPromptString(params.appResults.portalTemplate);
         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;
@@ -2247,6 +2426,7 @@ export default class Install extends Command {
             devDependencies: downloadResultsValue(params.downloadResults, 'devDependencies'),
             build: downloadResultsValue(params.downloadResults, 'build'),
             buildDts: downloadResultsValue(params.downloadResults, 'buildDts'),
+            hookScript: params.appResults.hookScript,
             ...(appPath ? { appPath } : {}),
             ...(appRootPath && !areConfiguredPathsEquivalent(appRootPath, derivedAppRootPath) ? { appRootPath } : {}),
             appPort,
@@ -2254,6 +2434,9 @@ export default class Install extends Command {
             ...(appPublicPath ? { appPublicPath } : {}),
             ...(envFile ? { envFile } : {}),
             lang: params.appResults.lang,
+            portalType,
+            portalName,
+            portalTemplate,
             appKey: params.appResults.appKey,
             timezone: params.appResults.timeZone,
             builtinDb: params.dbResults.builtinDb,
@@ -2305,13 +2488,17 @@ export default class Install extends Command {
                     '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),
+                    'portal-template': parsed['portal-template'] ?? Install.toOptionalPromptString(appPreset.portalTemplate),
                 },
             }),
             values: appPreset,
             yesInitialValues: { resume: parsed.resume },
             yes,
         });
-        const downloadOpts = Install.buildDownloadPromptOptionsForInstall(appResults, envName);
+        if (resumePreset?.appPreset?.hookScript !== undefined && appResults.hookScript === undefined) {
+            appResults.hookScript = resumePreset.appPreset.hookScript;
+        }
+        const downloadOpts = await Install.buildDownloadPromptOptionsForInstall(appResults, envName);
         downloadOpts.values = {
             ...(resumePreset?.downloadPreset ?? {}),
             ...downloadOpts.values,
@@ -2418,7 +2605,6 @@ 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.');
         }
@@ -2440,6 +2626,12 @@ export default class Install extends Command {
             appResults,
         });
         appResults.setupState = 'prepared';
+        await this.prepareHookScriptForInstall({
+            envName,
+            appResults,
+            downloadResults,
+            hookScript: parsed['hook-script'],
+        });
         const source = String(downloadResultsValue(downloadResults, 'source') ?? '').trim();
         const usesDockerResources = Boolean(dbResults.builtinDb) || source === 'docker';
         const dockerNetworkName = usesDockerResources
@@ -2492,8 +2684,7 @@ export default class Install extends Command {
             dbResults.dbUser = builtinDbPlan.dbUser;
             dbResults.dbPassword = builtinDbPlan.dbPassword;
         }
-        let dockerAppPlan;
-        let localAppPlan;
+        let shouldStartApp = false;
         if (source === 'docker' || source === 'npm' || source === 'git') {
             this.logStage('Preparing application');
             if (source === 'docker') {
@@ -2505,76 +2696,28 @@ export default class Install extends Command {
                     printInfo('Application image ready.');
                 }
                 if (!parsed['prepare-only']) {
-                    dockerAppPlan = await this.installDockerApp({
-                        envName,
-                        dockerNetworkName,
-                        dockerContainerPrefix,
-                        appResults,
-                        downloadResults,
-                        dbResults,
-                        rootResults,
-                        builtinDbPlan,
-                        force: parsed.force,
-                        commandStdio,
-                    });
-                    appResults.appKey = dockerAppPlan.appKey;
-                    appResults.timeZone = dockerAppPlan.timeZone;
+                    shouldStartApp = true;
                 }
             }
             else if (source === 'npm' || source === 'git') {
-                const localSource = source === 'npm' ? 'npm' : 'git';
-                const projectRoot = parsed['skip-download']
-                    ? Install.resolveLocalProjectRoot({
-                        envName,
-                        appResults,
-                        downloadResults,
-                    })
-                    : await this.downloadLocalApp({
+                if (!parsed['skip-download'] && !parsed['prepare-only']) {
+                    await this.downloadLocalApp({
                         envName,
                         appResults,
                         downloadResults,
                         verbose: parsed.verbose,
                     });
-                if (!parsed['skip-download']) {
                     printInfo('Application files ready.');
                 }
                 if (!parsed['prepare-only']) {
-                    localAppPlan = await this.startLocalApp({
-                        envName,
-                        source: localSource,
-                        projectRoot,
-                        appResults,
-                        dbResults,
-                        rootResults,
-                        commandStdio,
-                    });
-                    appResults.appKey = localAppPlan.appKey;
-                    appResults.timeZone = localAppPlan.timeZone;
+                    shouldStartApp = true;
                 }
             }
         }
         else {
             this.logDetail('Skipped app download and install.');
         }
-        if (dockerAppPlan || localAppPlan) {
-            this.logStage('Starting NocoBase');
-            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 ${formatInstallDisplayUrl(displayApiBaseUrl)}`);
-            appResults.setupState = 'installed';
-        }
-        if (dockerAppPlan || localAppPlan || builtinDbPlan) {
+        if (shouldStartApp || builtinDbPlan) {
             await this.saveInstalledEnv({
                 envName,
                 appResults,
@@ -2584,10 +2727,14 @@ export default class Install extends Command {
                 envAddResults,
             });
         }
+        if (shouldStartApp) {
+            this.logStage('Starting NocoBase');
+            await this.config.runCommand('app:start', this.buildAppStartArgv({ envName, verbose: parsed.verbose }));
+        }
         await this.syncInstalledEnvConnection({
             envName,
             envAddResults,
-            appReady: Boolean(dockerAppPlan || localAppPlan),
+            appReady: shouldStartApp,
             skipAuth: Boolean(parsed['skip-auth']),
         });
         if (!parsed['prepare-only']) {
@@ -2596,7 +2743,7 @@ export default class Install extends Command {
         if (parsed['prepare-only']) {
             printInfo(`Preparation complete for "${envName}". Activate the license, then run \`nb app start --env ${envName}\`.`);
         }
-        else if (!dockerAppPlan && !localAppPlan) {
+        else if (!shouldStartApp) {
             printInfo(`Install config for "${envName}" has been saved.`);
         }
     }