安装与首次初始化
使用当前源码构建默认 Compose 组合，配置持久化和首次登录。
准备条件
需要 Git、Docker 与 Compose，以及当前源码的访问权限。宿主不需要单独安装数据库。当前默认组合是 Core、Portal 和 mosaic-admin；SQLite、认证状态与媒体通过命名卷持久化，无需 Redis。
构建并启动
取得源码并复制生产模板。用本地受保护编辑器填写模板要求的独立随机密钥及真实访问地址，再启动。仓库没有默认管理员密码。
Terminal
git clone https://github.com/Morphicai/morphixai-cms.git mosaic-base
cd mosaic-base
cp .env.cms.example .env
# Configure the required secrets and origins locally.
docker compose -f docker-compose.cms.yml up -d --build访问与初始化
默认本机入口为 Portal http://localhost:8086 和后台 http://localhost:8090。Core 不默认暴露在生产宿主。打开后台 /setup 创建自己的账号；初始化成功后用实际验证码登录。
修改域名时同步配置 MOSAIC_ADMIN_PUBLIC_URL、MOSAIC_PORTAL_PUBLIC_URL、SITE_PUBLIC_URL 与认证 origin。正式公网登录使用 HTTPS；HTTP IP 下的 Cookie 行为不作为生产认证承诺。
保留数据与密钥
默认数据库、媒体和日志使用各自命名卷；认证状态保存在数据库，可选 Redis 使用独立卷。停止并重建时保留卷，不使用 down -v。密钥也要保持一致，尤其是加密与标识查找密钥。卷重建已验证，完整跨实例备份恢复仍延期。
Terminal
docker compose -f docker-compose.cms.yml logs --tail=100 core
docker compose -f docker-compose.cms.yml down
docker compose -f docker-compose.cms.yml up -d