Remove volta from documentation. Updated GHA instructions and Dockerfiles

kaisalmen · kaisalmen · commit d23725b88de0 · 2026-01-14T12:33:06.000+01:00
diff --git a/.github/workflows/debugger-py.yml b/.github/workflows/debugger-py.yml
@@ -2,9 +2,6 @@ name: Python Debugger Image
 
 on:
   workflow_dispatch:
-  push:
-    branches:
-      - issue-690-debugger
 
 env:
   REGISTRY: ghcr.io
@@ -26,7 +23,7 @@ jobs:
     timeout-minutes: 15
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Login to GitHub Container Registry
       uses: docker/login-action@v3
@@ -56,7 +53,7 @@ jobs:
         labels: ${{ steps.meta.outputs.labels }}
 
     - name: Attest
-      uses: actions/attest-build-provenance@v1
+      uses: actions/attest-build-provenance@v3
       with:
         subject-name: ${{ env.REGISTRY }}/${{ env.REPO_NAME }}/${{ env.CONTAINER_NAME }}
         subject-digest: ${{ steps.push.outputs.digest }}
diff --git a/.github/workflows/ghp.yml b/.github/workflows/ghp.yml
@@ -18,15 +18,10 @@ jobs:
 
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
-    - name: Volta
-      uses: volta-cli/action@v4
-
-    - name: Use pnpm
-      uses: pnpm/action-setup@v3
-      with:
-        version: 9
+    - name: mise-en-place
+      uses: jdx/mise-action@v2
 
     - name: Install
       shell: bash
@@ -51,7 +46,7 @@ jobs:
       uses: actions/configure-pages@v5
 
     - name: Upload artifact
-      uses: actions/upload-pages-artifact@v3
+      uses: actions/upload-pages-artifact@v4
       with:
         path: ./packages/examples/production/
 
diff --git a/.github/workflows/ls-clangd.yml b/.github/workflows/ls-clangd.yml
@@ -24,7 +24,7 @@ jobs:
     timeout-minutes: 150
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Login to GitHub Container Registry
       uses: docker/login-action@v3
@@ -54,7 +54,7 @@ jobs:
         labels: ${{ steps.meta_configure.outputs.labels }}
 
     - name: Attest (configure)
-      uses: actions/attest-build-provenance@v1
+      uses: actions/attest-build-provenance@v3
       with:
         subject-name: ${{ env.REGISTRY }}/${{ env.REPO_NAME }}/${{ env.CONTAINER_NAME_CONFIGURE }}
         subject-digest: ${{ steps.push_configure.outputs.digest }}
@@ -81,7 +81,7 @@ jobs:
         labels: ${{ steps.meta_build.outputs.labels }}
 
     - name: Attest (build)
-      uses: actions/attest-build-provenance@v1
+      uses: actions/attest-build-provenance@v3
       with:
         subject-name: ${{ env.REGISTRY }}/${{ env.REPO_NAME }}/${{ env.CONTAINER_NAME_BUILD }}
         subject-digest: ${{ steps.push_build.outputs.digest }}
diff --git a/.github/workflows/ls-eclipsejdt.yml b/.github/workflows/ls-eclipsejdt.yml
@@ -23,7 +23,7 @@ jobs:
     timeout-minutes: 15
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Login to GitHub Container Registry
       uses: docker/login-action@v3
@@ -53,7 +53,7 @@ jobs:
         labels: ${{ steps.meta.outputs.labels }}
 
     - name: Attest
-      uses: actions/attest-build-provenance@v1
+      uses: actions/attest-build-provenance@v3
       with:
         subject-name: ${{ env.REGISTRY }}/${{ env.REPO_NAME }}/${{ env.CONTAINER_NAME }}
         subject-digest: ${{ steps.push.outputs.digest }}
diff --git a/.github/workflows/ls-groovy.yml b/.github/workflows/ls-groovy.yml
@@ -23,7 +23,7 @@ jobs:
     timeout-minutes: 15
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: Login to GitHub Container Registry
       uses: docker/login-action@v3
@@ -53,7 +53,7 @@ jobs:
         labels: ${{ steps.meta.outputs.labels }}
 
     - name: Attest
-      uses: actions/attest-build-provenance@v1
+      uses: actions/attest-build-provenance@v3
       with:
         subject-name: ${{ env.REGISTRY }}/${{ env.REPO_NAME }}/${{ env.CONTAINER_NAME }}
         subject-digest: ${{ steps.push.outputs.digest }}
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -20,7 +20,7 @@ jobs:
 
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     - name: mise-en-place
       uses: jdx/mise-action@v2
diff --git a/.github/workflows/peer.yml b/.github/workflows/peer.yml
diff --git a/.github/workflows/verify.yml b/.github/workflows/verify.yml
@@ -13,15 +13,10 @@ jobs:
 
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
-    - name: Volta
-      uses: volta-cli/action@v4
-
-    - name: Use pnpm
-      uses: pnpm/action-setup@v3
-      with:
-        version: 9
+    - name: mise-en-place
+      uses: jdx/mise-action@v2
 
     - name: Install
       shell: bash
diff --git a/README.md b/README.md
@@ -84,11 +84,17 @@ Check find the [full compatibility table](https://github.com/TypeFox/monaco-lang
 
 ## Getting started
 
+We recommend [mise-en-place](https://mise.jdx.dev/) to setup corrects version of required tools like `node` and `npm` (described [here](./docs/guides/troubleshooting.md#mise-en-place)). If you have `mise` installed use the optional isntruction below.
+
 On your local machine you can prepare your dev environment as follows. At first it is advised to build everything. Locally, from a terminal do:
 
 ```bash
+# clone the git repository
 git clone https://github.com/TypeFox/monaco-languageclient.git
 cd monaco-languageclient
+# optional: if you have mise installed
+mise upgrade
+# install npm dependencies
 npm i
 # Cleans-up, compiles and builds everything
 npm run build
diff --git a/docs/guides/troubleshooting.md b/docs/guides/troubleshooting.md
@@ -64,9 +64,9 @@ If your dependency stack already contains a reference `monaco-editor` you must e
 }
 ```
 
-### Volta
+### mise-en-place
 
-There are [Volta](https://volta.sh/) instructions in the `package.json` files. When you have Volta available it will ensure the exactly specified `node` and `npm` versions are used.
+We use [mise-en-place](https://mise.jdx.dev/) for tool management. In the past we used Volta, but unfourtunately is has become unmaintained. We will phase out volta instructions in the future. In the repository root you find [mise.toml](../../mise.toml) which specifies all tools required with the correct versions. Use `mise upgrade` to install the required tools.
 
 ### Bad Polyfills
 
diff --git a/docs/installation.md b/docs/installation.md
@@ -13,7 +13,7 @@ Before installing Monaco Language Client, ensure you have:
 We recommend using a Node.js version manager such as [nvm](https://github.com/nvm-sh/nvm) or [mise](https://mise.jdx.dev/).
 
 > [!NOTE]
-> Previously we have recommended using Volta to manage your Node.js versions, but as of late it is currently [unmaintained](https://github.com/volta-cli/volta), and their team recommends moving to an alternative solution, such as mise or nvm.
+> Previously we have recommended using Volta to manage your Node.js versions, but as of late it is currently [unmaintained](https://github.com/volta-cli/volta). We now recommend to use [mise-en-place](https://mise.jdx.dev/). We will phase out volta instructions in the `monaco-languageclient` in the future.
 
 You'll also need a project that you can use to install the `monaco-languageclient`. If you don't have one yet, you can get [started quickly by creating a new Vite project](https://vite.dev/guide/#scaffolding-your-first-vite-project) with React:
 
diff --git a/package.json b/package.json
@@ -68,6 +68,8 @@
     "build:wrapper-react": "npm run build --workspace packages/wrapper-react",
     "build:examples": "npm run build --workspace packages/examples",
     "langium:generate": "npm run langium:generate --workspace packages/examples",
+    "start:example:server:groovy": "npm run start:server:groovy --workspace packages/examples",
+    "start:example:server:jdtls": "npm run start:server:jdtls --workspace packages/examples",
     "start:example:server:json": "npm run start:server:json --workspace packages/examples",
     "start:example:server:python": "npm run start:server:python --workspace packages/examples",
     "release:prepare": "npm run reset:repo && npm ci && npm run build && npm run lint && npm run test",
diff --git a/packages/client/CHANGELOG.md b/packages/client/CHANGELOG.md
@@ -4,7 +4,10 @@ All notable changes to this npm module are documented in this file.
 
 ## [10.6.0] - 2026-01-14
 
-- Updated all `@codingame/monaco-vscode` packages to `25.0.0`.
+- Update to monaco-vscode-api 25 [#1009](https://github.com/TypeFox/monaco-languageclient/pull/1009)
+  - Updated all `@codingame/monaco-vscode` packages to `25.0.0`.
+- Introduce mise-en-place [#1012](https://github.com/TypeFox/monaco-languageclient/pull/1012)
+- Remove own ConsoleLogger implementation in mlc/common [#1011](https://github.com/TypeFox/monaco-languageclient/pull/1011)
 
 ## [10.5.0] - 2025-12-23
 
diff --git a/packages/examples/CHANGELOG.md b/packages/examples/CHANGELOG.md
@@ -5,7 +5,10 @@ All notable changes to this npm module are documented in this file.
 ## [2026.1.1] - 2026-01-14
 
 - Updated to `monaco-languageclient@10.6.0` and `@typefox/monaco-editor-react@7.6.0`.
-- Updated all `@codingame/monaco-vscode` packages to `25.0.0`.
+- Update to monaco-vscode-api 25 [#1009](https://github.com/TypeFox/monaco-languageclient/pull/1009)
+  - Updated all `@codingame/monaco-vscode` packages to `25.0.0`.
+- Introduce mise-en-place [#1012](https://github.com/TypeFox/monaco-languageclient/pull/1012)
+- Remove own ConsoleLogger implementation in mlc/common [#1011](https://github.com/TypeFox/monaco-languageclient/pull/1011)
 
 ## [2025.12.1] - 2025-12-23
 
diff --git a/packages/examples/package.json b/packages/examples/package.json
@@ -153,6 +153,8 @@
     "resources:download": "tsx ./resources/scripts/downloadResources.ts",
     "build:msg": "echo Building main examples:",
     "build": "npm run build:msg && npm run clean && npm run resources:download && npm run extract:docker && npm run compile",
+    "start:server:groovy": "tsx src/groovy/server/direct.ts",
+    "start:server:jdtls": "tsx src/eclipse.jdt.ls/server/direct.ts",
     "start:server:json": "tsx src/json/server/direct.ts",
     "start:server:python": "tsx src/python/server/direct.ts",
     "langium:generate:statemachine": "langium generate --file ./src/langium/statemachine/config/langium-config.json",
diff --git a/packages/examples/resources/clangd/configure.Dockerfile b/packages/examples/resources/clangd/configure.Dockerfile
@@ -4,14 +4,6 @@ RUN apt update \
     && apt upgrade -y \
     && apt install -y curl git wget build-essential cmake ninja-build python3
 
-RUN curl https://get.volta.sh | bash
-ENV VOLTA_FEATURE_PNPM=1
-ENV VOLTA_HOME "/root/.volta"
-ENV PATH "$VOLTA_HOME/bin:$PATH"
-
-RUN volta install node \
-    && volta install pnpm
-
 RUN mkdir /builder
 
 COPY configure-docker.sh /builder/configure-docker.sh
diff --git a/packages/examples/resources/debugger/Dockerfile b/packages/examples/resources/debugger/Dockerfile
@@ -1,14 +1,19 @@
-FROM ghcr.io/graalvm/graalpy-community:24
+FROM ghcr.io/graalvm/graalpy-community:25
 
-RUN curl https://get.volta.sh | bash
-ENV VOLTA_FEATURE_PNPM=1
-ENV VOLTA_HOME="/root/.volta"
-ENV PATH="$VOLTA_HOME/bin:$PATH"
+SHELL ["/bin/bash", "-o", "pipefail", "-c"]
+ENV MISE_DATA_DIR="/mise"
+ENV MISE_CONFIG_DIR="/mise"
+ENV MISE_CACHE_DIR="/mise/cache"
+ENV MISE_INSTALL_PATH="/usr/local/bin/mise"
+ENV PATH="/mise/shims:$PATH"
 
-RUN volta install node@22
+# install mise
+RUN curl https://mise.run | sh
 
-RUN mkdir -p /home/mlc/workspace
-RUN mkdir -p /home/mlc/server/src
+# configure mise
+RUN mise use --global node@24
+
+RUN mkdir -p /home/mlc/workspace && mkdir -p /home/mlc/server/src
 
 COPY ./packages/examples/resources/debugger/package.json /home/mlc/server
 COPY ./packages/examples/src/debugger/server/debugServer.ts /home/mlc/server/src
diff --git a/packages/examples/resources/eclipse.jdt.ls/Dockerfile b/packages/examples/resources/eclipse.jdt.ls/Dockerfile
@@ -1,22 +1,30 @@
-FROM eclipse-temurin:17-jdk
+FROM eclipse-temurin:21-jdk
+
+RUN apt update \
+    && apt upgrade -y \
+    && apt install -y wget curl
+
+SHELL ["/bin/bash", "-o", "pipefail", "-c"]
+ENV MISE_DATA_DIR="/mise"
+ENV MISE_CONFIG_DIR="/mise"
+ENV MISE_CACHE_DIR="/mise/cache"
+ENV MISE_INSTALL_PATH="/usr/local/bin/mise"
+ENV PATH="/mise/shims:$PATH"
+
+# install mise
+RUN curl https://mise.run | sh
+
+# configure mise
+RUN mise use --global node@24
 
 ARG PATH_MLC=/home/mlc
 ARG PATH_ECLIPSE_JDT=${PATH_MLC}/packages/examples/resources/eclipse.jdt.ls/ls
-ARG JDT_TAR_URL=https://download.eclipse.org/jdtls/milestones/1.37.0/jdt-language-server-1.37.0-202406271335.tar.gz
+ARG JDT_TAR_URL=https://download.eclipse.org/jdtls/milestones/1.55.0/jdt-language-server-1.55.0-202601131729.tar.gz
 ARG JDT_TAR_LOCAL=eclipse.jdt.ls.tar.gz
 
-RUN apt update \
-    && apt upgrade -y
-RUN apt install -y wget
-
-RUN curl https://get.volta.sh | bash
-ENV VOLTA_FEATURE_PNPM=1
-ENV VOLTA_HOME="/root/.volta"
-ENV PATH="$VOLTA_HOME/bin:$PATH"
-RUN volta install node@20
-
 # prepare
-RUN mkdir -p ${PATH_MLC}
+RUN mkdir -p ${PATH_MLC} \
+    && mise trust ${PATH_MLC}
 
 # copy repo content
 COPY ./ ${PATH_MLC}
diff --git a/packages/examples/resources/groovy/Dockerfile b/packages/examples/resources/groovy/Dockerfile
@@ -1,23 +1,31 @@
-FROM gradle:7-jdk17-focal
+FROM gradle:9-jdk21
+
+RUN apt update \
+    && apt upgrade -y \
+    && apt install -y curl
+
+SHELL ["/bin/bash", "-o", "pipefail", "-c"]
+ENV MISE_DATA_DIR="/mise"
+ENV MISE_CONFIG_DIR="/mise"
+ENV MISE_CACHE_DIR="/mise/cache"
+ENV MISE_INSTALL_PATH="/usr/local/bin/mise"
+ENV PATH="/mise/shims:$PATH"
+
+# install mise
+RUN curl https://mise.run | sh
+
+# configure mise
+RUN mise use --global node@24
 
 ARG HOME_DIR=/home/gradle
 ARG PATH_MLC=${HOME_DIR}/mlc
 ARG PATH_GLS=${HOME_DIR}/groovy-language-server
 ARG PATH_GROOVY_JAR=${PATH_MLC}/packages/examples/resources/groovy/lib
 
-RUN apt update \
-    && apt upgrade -y
-RUN apt install -y curl
-
-RUN curl https://get.volta.sh | bash
-ENV VOLTA_FEATURE_PNPM=1
-ENV VOLTA_HOME="/root/.volta"
-ENV PATH="$VOLTA_HOME/bin:$PATH"
-RUN volta install node@20
-
 # prepare
 RUN cd ${HOME_DIR} \
-    && mkdir -p ${PATH_MLC}
+    && mkdir -p ${PATH_MLC} \
+    && mise trust ${PATH_MLC}
 
 # build groovy language server
 RUN cd ${HOME_DIR} \
diff --git a/packages/wrapper-react/CHANGELOG.md b/packages/wrapper-react/CHANGELOG.md

Original file line number	Diff line number	Diff line change
@@ -64,9 +64,9 @@ If your dependency stack already contains a reference `monaco-editor` you must e
`64`	`64`	`}`
`65`	`65`	```
`66`	`66`
`67`		`-### Volta`
	`67`	`+### mise-en-place`
`68`	`68`
`69`		-There are [Volta](https://volta.sh/) instructions in the `package.json` files. When you have Volta available it will ensure the exactly specified `node` and `npm` versions are used.
	`69`	+We use [mise-en-place](https://mise.jdx.dev/) for tool management. In the past we used Volta, but unfourtunately is has become unmaintained. We will phase out volta instructions in the future. In the repository root you find [mise.toml](../../mise.toml) which specifies all tools required with the correct versions. Use `mise upgrade` to install the required tools.
`70`	`70`
`71`	`71`	`### Bad Polyfills`
`72`	`72`