Skip to main content
这个脚本会把 .env.example 复制成 .env，把仍是模板值的密码和 JWT 密钥换成随机值，然后把整栈拉起来。 它是幂等的——改完 .env 再跑一次即可。

​
会起来哪些服务

Postgres 必须带着 shared_preload_libraries=timescaledb 启动，compose 文件里已经设了。 但如果数据卷最初是用普通 postgres 初始化的，它的 postgresql.conf 里不会有这一项， hypertable 迁移就会失败。要么从干净的卷开始，要么手动补上这项设置。

​
开始之前

1

设定存储根

Compose 会把它以完全相同的路径 bind-mount 进容器。这不是为了好看： 用 local 执行器时控制台驱动的是宿主机的 Docker daemon，-v 左边那个是宿主机路径。 两边不一致，控制台就看不到作业写了什么。
2

把 docker 组给容器

控制台以 uid/gid 10001 运行，需要能写 /var/run/docker.sock。
3

决定 GPU 怎么处理

compose 文件里写了 gpus: all，让 NVIDIA toolkit 把 nvidia-smi 和驱动库注入进来—— 控制台能看见卡，但不占用它们。没有 NVIDIA 运行时的机器上，删掉 gpus: all 和 NVIDIA_DRIVER_CAPABILITIES 那两行， 然后显式设 FORGE_LOCAL_GPU_COUNT。
4

启动

​
内网域名

容器不读宿主机的 /etc/hosts。如果你的 OIDC 提供方或镜像站只能靠那份文件解析，就补上映射：

​
推荐配置

其余项都有可用的默认值，这几项没有。
.env
FORGE_INGEST_URL 是最容易配错的一项。训练容器要往它 POST 指标， 而在 local 执行器下它们共用宿主机网络——所以 127.0.0.1 在那里能用， 但你一加第二台机器它就失效了。一开始就填宿主机的真实地址。
数据库和 Redis 的主机名是 compose 服务名，只在 starforge-internal 网络内可解析。 整栈用 compose 拉起来；单独 docker run 应用镜像会报 failed to resolve host 'postgres'。

​
确认成功

然后打开控制台。首次访问会走引导流程创建第一个管理员。

​
从一台机器往外走

Compose 加 local 后端的上限就是一台主机。不够用时，做法是再注册一个 Fleet，而不是做一次迁移： 用 node Fleet 管几台裸机， 或者把控制台本身搬进 Kubernetes。已经在第一个 Fleet 上的作业 不用动。