Skip to content

7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.

TypeScript

chore(release): prepare v0.16.8 on Node 24 (#1673)

Tashfeen14dade645754
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 6cd1087e..6686fff2 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -13,10 +13,11 @@ jobs:
strategy:
fail-fast: false
matrix:
- # Both ends of the supported engines range (package.json: >=20.18 <25).
- # 20 is the CI baseline that has historically caught crashes newer local
- # Node versions hid; 22 is the current LTS most contributors run.
- node-version: ['20', '22']
+ # The supported engines range (package.json: >=20.18 <25). 20 is the
+ # CI baseline that has historically caught crashes newer local Node
+ # versions hid; 22 is the LTS most contributors run; 24 is what the
+ # Docker image ships since the Node 20 line reached end of life.
+ node-version: ['20', '22', '24']
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
diff --git a/Dockerfile b/Dockerfile
index 1efb0539..228c81dd 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,6 +1,6 @@
# syntax=docker/dockerfile:1.7
-ARG NODE_IMAGE=node:20-bookworm-slim
+ARG NODE_IMAGE=node:24.22.1-bookworm-slim
FROM ${NODE_IMAGE} AS deps
WORKDIR /app
diff --git a/desktop/package-lock.json b/desktop/package-lock.json
index f0dad5d6..2295f9d1 100644
--- a/desktop/package-lock.json
+++ b/desktop/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "freellmapi-desktop",
- "version": "0.16.7",
+ "version": "0.16.8",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "freellmapi-desktop",
- "version": "0.16.7",
+ "version": "0.16.8",
"dependencies": {
"better-sqlite3": "^12.10.0",
"electron-updater": "^6.8.9"
diff --git a/desktop/package.json b/desktop/package.json
index a9e1d1a3..421b2306 100644
--- a/desktop/package.json
+++ b/desktop/package.json
@@ -1,6 +1,6 @@
{
"name": "freellmapi-desktop",
- "version": "0.16.7",
+ "version": "0.16.8",
"description": "FreeLLMAPI menu-bar app — local OpenAI-compatible LLM router",
"author": {
"name": "tashfeenahmed",
diff --git a/docker-entrypoint.sh b/docker-entrypoint.sh
index 7e987b5f..35333351 100755
--- a/docker-entrypoint.sh
+++ b/docker-entrypoint.sh
@@ -43,7 +43,7 @@ if [ "$(id -u)" = "0" ]; then
ensure_owned "$(dirname "$FREEAPI_DB_BACKUP_PATH")"
fi
- # setpriv ships in util-linux on node:20-bookworm-slim, so it is always
+ # setpriv ships in util-linux on node:24-bookworm-slim, so it is always
# present; exec'ing it keeps node as PID 1 so signals reach the server.
exec setpriv --reuid=node --regid=node --init-groups -- "$@"
fi
diff --git a/docs/en/deployment/01-docker.md b/docs/en/deployment/01-docker.md
index 176e81cc..6148a269 100644
--- a/docs/en/deployment/01-docker.md
+++ b/docs/en/deployment/01-docker.md
@@ -25,7 +25,7 @@ Published tags: `latest` (default branch), `v*.*.*` (git release tags), and `sha
Build shape ([Dockerfile](../../../Dockerfile)):
-- Three stages on the `node:20-bookworm-slim` base (`deps` → `build` → `runtime`); only already-built artifacts are copied into the runtime stage.
+- Three stages on the `node:24-bookworm-slim` base (`deps` → `build` → `runtime`); only already-built artifacts are copied into the runtime stage.
- The runtime sets `NODE_ENV=production`, `PORT=3001`, and `FREELLMAPI_INSTALL_METHOD=docker`; the process is `node server/dist/index.js`.
- A `FREELLMAPI_COMMIT_SHA` ARG/ENV pair sits deliberately after all `COPY` layers: the SHA changes every commit, and placing it higher would invalidate the layer cache for the whole image on each build.
- The runtime also copies `desktop/package.json` (a 400-byte manifest) so a container install can name its own release version (#703).
diff --git a/docs/en/deployment/OVERVIEW.md b/docs/en/deployment/OVERVIEW.md
index 5c411209..03c68a55 100644
--- a/docs/en/deployment/OVERVIEW.md
+++ b/docs/en/deployment/OVERVIEW.md
@@ -12,7 +12,7 @@ For installation paths beyond Docker (one-liner script, local development, deskt
| File | Description |
| --- | --- |
-| [01-docker.md](01-docker.md) | The image (multi-stage build on `node:20-bookworm-slim`), Compose quickstart, ports and LAN access, volumes and persistence, healthcheck, non-root runtime, native `better-sqlite3` compile rationale, and why a container cannot reach providers the host can (#733). |
+| [01-docker.md](01-docker.md) | The image (multi-stage build on `node:24-bookworm-slim`), Compose quickstart, ports and LAN access, volumes and persistence, healthcheck, non-root runtime, native `better-sqlite3` compile rationale, and why a container cannot reach providers the host can (#733). |
| [02-updates-and-backup.md](02-updates-and-backup.md) | Upgrade flow (`docker compose pull && docker compose up -d`), the dashboard update checker (#635/#703), backing up the SQLite data volume, and declarative config/catalog controls (#f4cd7b4). |
## Quick facts
diff --git a/docs/en/testing/01-running-tests.md b/docs/en/testing/01-running-tests.md
index 22c6fa82..19552a1a 100644
--- a/docs/en/testing/01-running-tests.md
+++ b/docs/en/testing/01-running-tests.md
@@ -48,7 +48,7 @@ npm run check:i18n -w client # scripts/check-i18n.mjs
## CI summary
-[`.github/workflows/ci.yml`](../../../.github/workflows/ci.yml) runs on `ubuntu-24.04`, on pushes and PRs targeting `main`, as a single `test` job across a Node matrix of **20 and 22** — both ends of the supported engines range (`>=20.18 <25`). Node 20 is the baseline that historically caught crashes newer local Node hid; 22 is the LTS most contributors run. Steps, in order:
+[`.github/workflows/ci.yml`](../../../.github/workflows/ci.yml) runs on `ubuntu-24.04`, on pushes and PRs targeting `main`, as a single `test` job across a Node matrix of **20, 22 and 24**, the supported engines range (`>=20.18 <25`). Node 20 is the baseline that historically caught crashes newer local Node hid; 22 is the LTS most contributors run; 24 is what the Docker image ships. Steps, in order:
1. checkout + setup-node (with npm cache)
2. `npm install`
diff --git a/docs/zh-cn/deployment/01-docker.md b/docs/zh-cn/deployment/01-docker.md
index a4b3cbd2..cd2f4f1e 100644
--- a/docs/zh-cn/deployment/01-docker.md
+++ b/docs/zh-cn/deployment/01-docker.md
@@ -25,7 +25,7 @@ docker pull ghcr.io/tashfeenahmed/freellmapi:latest # 或固定到某个发布
构建形态([Dockerfile](../../../Dockerfile)):
-- 基于 `node:20-bookworm-slim` 的三个阶段(`deps` → `build` → `runtime`);只有已构建完成的产物会被复制进 runtime 阶段。
+- 基于 `node:24-bookworm-slim` 的三个阶段(`deps` → `build` → `runtime`);只有已构建完成的产物会被复制进 runtime 阶段。
- runtime 阶段设置 `NODE_ENV=production`、`PORT=3001` 和 `FREELLMAPI_INSTALL_METHOD=docker`;进程为 `node server/dist/index.js`。
- 一对 `FREELLMAPI_COMMIT_SHA` ARG/ENV 刻意放在所有 `COPY` 层之后:SHA 每次提交都会变,放得更高会让每次构建都使整个镜像的层缓存失效。
- runtime 还会复制 `desktop/package.json`(一个约 400 字节的清单),让容器安装能报出自己的发布版本(#703)。
diff --git a/docs/zh-cn/deployment/OVERVIEW.md b/docs/zh-cn/deployment/OVERVIEW.md
index 4580875a..1514bc34 100644
--- a/docs/zh-cn/deployment/OVERVIEW.md
+++ b/docs/zh-cn/deployment/OVERVIEW.md
@@ -12,7 +12,7 @@ Docker 之外的安装路径(一行命令脚本、本地开发、桌面应用
| 文件 | 说明 |
| --- | --- |
-| [01-docker.md](01-docker.md) | 镜像本身(基于 `node:20-bookworm-slim` 的多阶段构建)、Compose 快速开始、端口与局域网访问、卷与持久化、健康检查、非 root 运行时、原生 `better-sqlite3` 编译缘由,以及为什么容器够不着宿主机能到达的提供方(#733)。 |
+| [01-docker.md](01-docker.md) | 镜像本身(基于 `node:24-bookworm-slim` 的多阶段构建)、Compose 快速开始、端口与局域网访问、卷与持久化、健康检查、非 root 运行时、原生 `better-sqlite3` 编译缘由,以及为什么容器够不着宿主机能到达的提供方(#733)。 |
| [02-updates-and-backup.md](02-updates-and-backup.md) | 升级流程(`docker compose pull && docker compose up -d`)、仪表盘更新检查器(#635/#703)、SQLite 数据卷的备份,以及声明式配置/目录控制项(#f4cd7b4)。 |
## 速览