Questions
简体中文Back to Questions

Work / Intelligence / Cash · Work

How do I install TeX Live and the Work Windows connector?

Install TeX Live first, install Bridge second, then return to Work to verify the Windows local connection and TeX availability.

Understand the two components: TeX Live is a TeX distribution providing engines such as XeLaTeX and pdfLaTeX, packages, and font support. Bridge is the local Windows component connecting the Work website to that computer. Downloading an ISO does not install TeX Live. Bridge can connect without TeX Live, but local TeX compilation requires a detectable TeX engine.

Step 1 | Download TeX Live: On Work's Local Connection page, select Download TeX Live (ISO), acknowledge the network warning, and open the supplied Microsoft OneDrive page to obtain texlive.iso. Access may depend on your network. Verify the filename and download source and allow sufficient disk space. An ISO is installation media, not the Bridge executable or an already installed program.

Step 2 | Install TeX Live: In Windows File Explorer, double-click the ISO or choose Mount, open the virtual drive, and run install-tl-windows.bat from the image root. Follow the installer, select a scheme and destination, and wait for the installation to finish. Prefer an installation path without non-ASCII characters. Mounting the image alone is not an installation.

Step 3 | Verify the compiler: Open a new Command Prompt or PowerShell window and run xelatex --version. For pdfLaTeX, optionally run pdflatex --version. If the command cannot be found, verify the installation and that TeX Live's bin/windows directory is on PATH, then open a new terminal. You may need to restart Bridge after changing the environment.

Step 4 | Install Bridge: Return to Work's Local Connection page, select Install Windows component, download -Bridge.exe, and run it once. It installs into the current Windows user's local application data and configures background startup at sign-in. It does not need a separate Node.js or PowerShell installation. Obtain the executable only from the official Work page.

Step 5 | Check the connection: On the same Windows computer, choose Check again on the Local Connection page. The expected result is Connected for the bridge and Available for TeX. Connected means only that the website can reach Bridge; if TeX is still unavailable, investigate the TeX installation, compiler path, environment, and whether Bridge needs restarting.

Step 6 | Compile documents: Open Work's TeX workbench, edit a document, and choose XeLaTeX or pdfLaTeX to compile. XeLaTeX is often suitable for Chinese documents. The current native Windows Bridge allows local XeLaTeX and pdfLaTeX only; other engines appearing in the web interface are not automatically supported for local compilation.

Troubleshooting | If Bridge remains disconnected, confirm it has started, reload the page, and check whether the browser can access loopback address 127.0.0.1:32145. Review local-network browser permissions and security-software prompts without disabling system-wide protection. If the bridge connects but compilation fails, read the TeX log for missing packages, fonts, or source errors.

Privacy and scope | A connection check only inspects local service availability; it does not pass account credentials or document contents as connection-check data. An actual local compilation sends the TeX source to the Bridge on that computer, which is separate from any cloud document-saving features. This guide applies to Windows and is not a setup guide for macOS or Linux.

References | For TeX Live installation details, refer to the TeX Users Group documentation at tug.org/texlive. For the Bridge download and connection status, use the official Work Local Connection page. The version and availability of the linked OneDrive ISO may change.