Skip to main content

Quickstart

Get your first remote LaTeX build running in minutes.

Install​

brew install texops/tap/tx

Authenticate​

Registration is open — running tx login creates your account automatically.

tx login

A device code appears in your terminal. Open the verification page, enter the code with your email, and click the magic link sent to your inbox.

info

Credentials are stored in your system keyring and persist for 30 days.

Initialize a project​

In your LaTeX project directory:

tx init

This scans for .tex files containing \documentclass, prompts you to select documents, a TeX Live version, and a compiler, then writes a .texops.yaml config file. Commit it to version control.

To skip the interactive prompts:

tx init --texlive 2025 --compiler pdflatex

Build​

tx build

Files are synced to TexOps, compiled remotely, and the resulting PDF is downloaded to your working directory. Only changed files are uploaded on subsequent builds.

To build a specific document:

tx build paper

Next steps​

  • Configuration — customize your .texops.yaml and control which files are uploaded
  • CI/CD — set up automated builds with API tokens
  • CLI Reference — full list of commands and flags