Repository navigation
Releases
Codex Remote Web 0.2.0-beta.1
Beta.1 brings two main updates:
- Desktop background gateway: macOS, Windows and Linux tray/settings apps for setup, gateway controls and remote access, with coordinated themes and reduced-motion-aware transitions.
- Shared conversations and longer sign-in: shared Codex daemon mode is now the default; new fixed-domain Access applications use 30-day application sessions. Existing Access applications require deliberate migration.
Ten packages are available: DMG, MSI, two DEBs, four portable CLI archives and two Linux deployment archives. Check your download against its .sha256 or SHA256SUMS. Desktop packages are unsigned; additional manual OS trust/login and live authentication acceptance remains deferred.
Before upgrading, stop gateways sharing state and back up configuration and execution records. Dedicated deployments without a shared daemon must explicitly select isolated mode.
Upgrade, requirements and limitations · Verification scope
Beta.1 包含两个主要部分:
- 桌面后台网关: macOS、Windows、Linux 提供托盘与设置页面,支持初始化、启停和远程访问,统一主题并提供遵循系统偏好的动效。
- 共享会话与更长登录: 默认连接共享 Codex daemon;新建固定域名 Access 应用使用 30 天应用会话,已有应用需另行迁移。
提供十个安装/归档包及校验文件。桌面包尚未签名,额外原生人工验收仍暂缓。升级前停止共享状态的网关并备份配置及执行记录;没有共享 daemon 的专用部署须显式选择 isolated 模式。详细要求、升级和限制见上方文档。
Codex Remote Web 0.2.0-alpha.3
Native installers for macOS Apple Silicon and Windows x64, alongside Linux x64/arm64. Bun, Node and terminal modules are bundled; configure Codex CLI and Git separately.
| Platform | Recommended download | Also available |
|---|---|---|
| Linux | x64 / arm64 | JS deployment archives |
| macOS 15+ · Apple Silicon | DMG | Portable tar.gz |
| Windows 11 · x64 · NTFS | MSI | Portable ZIP |
Verify the matching .sha256 or SHA256SUMS. DMG supports drag-to-Applications; MSI installs for the current user with Start menu and uninstall support. Open http://127.0.0.1:8899 after starting the gateway.
Packages are unsigned. Automatic service setup remains Linux-only; macOS/Windows use manual Tunnel + Access. Windows temporary access, Intel Mac and Windows ARM64 are unsupported. This remains an Alpha pre-release.
Platform setup · Install, upgrade and rollback
新增 macOS Apple Silicon DMG 和 Windows x64 MSI,继续提供 Linux x64/arm64 与各平台便携包。内置 Bun、Node 和终端模块,需自行配置 Codex CLI、Git。
下载后核对对应 .sha256 或 SHA256SUMS。DMG 拖入 Applications;MSI 支持当前用户安装、开始菜单和卸载。启动后打开 **http://127.0.0.1:8899**。
安装包暂未签名;自动服务配置仍限 Linux,其他平台需手动配置 Tunnel + Access。Windows 暂不支持临时访问,不支持 Intel Mac 或 Windows ARM64。本版保持 Alpha 预发布定位。
Codex Remote Web 0.2.0-alpha.2
Codex Remote Web · First public Alpha
A self-hosted Codex workspace for desktop, tablet and mobile browsers, with guided Cloudflare Tunnel + Access setup and protected temporary access without a domain.
- Chat, live progress, persistent queues and Side chat.
- File explorer, code/Markdown editing, attachments and image previews.
- Skills/plugins management, scheduled tasks and English/Chinese UI.
Download & run
| Package | Choose this for |
|---|---|
linux-x64.tar.gz / linux-arm64.tar.gz |
Ready-to-run executables with bundled runtimes and terminal module; no Bun/Node installation or compilation |
deployment-linux-*.tar.gz |
Prebuilt JS deployment; requires Bun, Node and dependency installation |
| Source code | Development or building your own package |
Choose x64 for x86_64 or arm64 for aarch64. Executable packages require Linux with glibc and libstdc++; tested on Ubuntu 24.04. Configure Codex CLI and Git separately; remote access also requires cloudflared. Keep the entire extracted directory.
# Download the matching archive and its .sha256 file first.
archive=codex-remote-web-0.2.0-alpha.2-linux-x64.tar.gz
sha256sum -c "$archive.sha256"
tar -xzf "$archive"
cd codex-remote-web-0.2.0-alpha.2
CODEX_WEBUI_CWD=/path/to/your/project ./codex-remote-webOpen http://127.0.0.1:8899, then Settings → Remote access for public access.
Alpha scope: one trusted personal workspace. No 32-bit ARM or Alpine/musl support. Back up state and stop older gateways before upgrading; uncertain submissions require review rather than automatic replay.
Getting started · Full release notes & upgrade guide · Changelog
中文
首个公开 Alpha:为电脑、平板和手机提供自托管 Codex 工作区,核心是 Cloudflare Tunnel + Access 网页配置,也支持无域名的受保护临时访问。
支持聊天与实时进度、持久队列、Side chat、文件树与代码/Markdown 编辑、附件与图片、技能/插件管理和后台定时任务。
**推荐下载可执行包:**x86_64 选 linux-x64,aarch64 选 linux-arm64;内置运行时和终端模块,无需安装 Bun/Node 或现场编译。下载归档及同名 .sha256,按上方命令校验、解压并启动,arm64 用户替换文件名。保留完整目录,自行配置 Codex CLI 和 Git;公网另需 cloudflared。
访问 **http://127.0.0.1:8899**,通过 设置 → Remote access 配置公网。deployment-linux-* 为需安装依赖的 JS 部署包,Source code 用于源码开发。
面向单人受信任工作区;Linux 需要 glibc/libstdc++,已在 Ubuntu 24.04 验证,不支持 32 位 ARM 或 Alpine/musl。升级前备份并停止旧网关;结果不明的提交请先核对。