= Download = < [[Installation hints]] | [[TeX Distributions]] ul id="DownloadRework">
<li>
=== Windows ===
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-mswin.zip 32bits]
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-win64.zip 64bits]
* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-windows-arm64.zip 64bits]
</li>
{{note | The officially recommended way of installing ConTeXt on all platforms is using [[ConTeXt Standalone|ConTeXt Suite]]}}<li>
=== macOS ===
* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-osx-64.zip 64bits]
* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-osx-arm64.zip 64bits]
</li>
= Look before you leap =<li>
Most === GNU/Linux ===* X86 [https://lmtx.pragma-ade.com/install-lmtx/context-linux.zip 32bits]* X86 [TeX Distributionshttps://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip 64bits]* ARM [https://lmtx.pragma-ade.com/install-lmtx/context-linux-aarch64.zip 64bits] include an installation of ConTeXt already* Musl [https://lmtx.To see if it's installed on your system run pragma-ade.nl/install-lmtx/context -linuxmusl-version64.zip 64bits]</li>
If it is not installed, there are two important considerations.
* Do you want a '''ConTeXt distribution''' or do you want a '''TeX distribution''' (plain TeX, LaTeX, ConTeXt, and lots of other goodies). * Do you want a '''stable''' version of ConTeXt, or do you want the '''bleeding edge''' version. Remember that ConTeXt gets updated frequently.<li>
If you are on a Linux system, there is also a third consideration=== FreeBSD ===* 14.0 [https://lmtx.pragma-ade.com/install-lmtx/context-freebsd-amd64.zip 64bits]</li>
<li> === OpenBSD ===* Do you want a '''distribution package'''7.4 [https://lmtx.pragma-ade.nl/install-lmtx/context-openbsd-amd64.zip 64bits]</li></ul></li> </ul> </li></ul> You can [[Read Me| read the licence]] (Creative Commons GNU GPL for program code, or do you want your own '''local TeX''' installationand Creative Commons Attribution ShareAlike for documentation).
= Installation =
select your operating system
The general steps to install ConTeXt LMTX are as follows: # Create a directory for ConTeXt.# Download the platform-specific archive file into the ConTeXt directory.# Unpack the archive.# Execute the install program, which downloads the distribution.# Update the PATH environment variable.# Generate cache# Optionally, delete the archive file. See the next sections for instructions specific to various platforms. == GNU/Linux == The steps in this section show how to download and install ConTeXt for a 64-bit Linux system. Change the archive file download link as needed for your target platform. Open a new terminal then run the following commands: # <code>mkdir $HOME/context</code> and <code>cd $HOME/context</code># <code>wget https://lmtx.pragma-ade.com/install-lmtx/context-linux-64.zip</code># <code>unzip context-linux-64.zip</code># <code>sh install.sh</code># Update the PATH environment variable by using the path instructions displayed when the install program finishes. The instructions will vary depending on the type of shell being used:#* <kbd>'''Bash: '''</kbd> <code>echo 'export PATH=...instructions...:$PATH' >> ~/.bashrc</code>#* <kbd>'''Zsh: '''</kbd> <code>echo 'export PATH=...instructions...:$PATH' >> ~/.zshenv</code>#* <kbd>'''Sh/Ksh: '''</kbd> <code>echo 'export PATH=...instructions...:$PATH' >> ~/.profile</code>#* <kbd>'''Tcsh/csh:'''</kbd> <code>echo 'set path = Unix ($path ...instructions...)' >> ~/.cshrc</code>#* For example, if ConTeXt was downloaded into `$HOME/context` on a system running bash, then the following line would update the PATH environment variable: <code>echo 'export PATH=$HOME/context/tex/texmf-linux-64/bsdbin:$PATH' >> ~/.bashrc</code># Then generate the cache with <code>mtxrun --generate</code>.# <code>rm context-linux-64.zip</code> == macOS == The instructions for MacOS are the same as for Unix, but note that: * MacOS versions from Catalina (10.15) and newer use '''Zsh''' by default.* MacOS versions before Catalina use '''Bash''' by default.* You might need to de-quarantine the binaries (and sometimes every created PDF) :** <code>sudo xattr -r -d com.apple.quarantine bin/mtxrun</code>** <code>sudo xattr -r -d com.apple.quarantine tex/texmf-osx-64/bin/*</code> == Windows ==In decreasing order of simplicity, here are a few optionsComplete the following steps to set up ConTeXt on Windows:
* (simplest) If you distribution supports [[TeX Live]] packages# Create a directory for ConTeXt, use themsuch as <code>C:\context</code>.# Download the architecture-specific version into the ConTeXt directory. Debian, Ubuntu, openSUSE, Gentoo, Fedora, Arch and Mandriva (if not too old) do so# Extract the archive. See [[Debian installation]] or [[Ubuntu installation]]# Run: <code>install.bat</code>* Otherwise, use a fresh [[TeX Live]] installation# Run: <code>setpath. The problem bat</code># Then generate the cache with this method is that you'll probably have to redo the installation once command <code>mtxrun --generate</code> in a year, when the new TeX Live DVD comes outcommand prompt.If you will use TeX Live, you have to delete # Delete the distributionfile archive file context-provided teTeX packages (if they exist)*win*.zip.
If you are running an rpm-based distribution (RedHat, Fedora, Mandrake, Mandriva etc.), then you can most easily uninstall them like so: rpm --qa | grep tetex rpm --erase <package-names><code>rpm</code>'s dependencies will tell you what other TeX-related packages are installed but don't have 'tetex' in their names!= Check the installation =
FreeBSD also still contains teTeX in its ports distribution (with many dependencies)Make sure that ConTeXt is installed on your system. These packages can be deleted as follows: pkg_info | grep tetex pkg_delete tetex\*Note, however, To check that teTeX will again be pulled-in by other packages, for example if options installing formatted documentation are activated. go to the command prompt and type
* Alternatively, if you need '''just ConTeXt and no LaTeX''', you can use the [[ConTeXt Standalone]] installation. The ConTeXt Standalone installation does not require the de context -installation of other TeX distributions and can be used in parallel.-version
=== Debian / (K)Ubuntu ===Debian_TeXlive_install (Debian/linux and Debian/kfreebsd)* [[Debian installation| install ConTeXt on Debian]]* [[Ubuntu installation| install ConTeXt on Ubuntu]]* [[Debian TeXlive install| install TeXlive on Debian]]You should get an output as follows:
=== Fedora === mtx-context | ConTeXt Process Management 1.06 mtx-context | mtx-context | main context file: /home/myuser/context/tex/texmf-context/tex/context/base/mkiv/context.mkiv mtx-context | current version: 2024.04.01 08:59 mtx-context | main context file: /home/myuser/context/tex/texmf-context/tex/context/base/mkxl/context.mkxl mtx-context | current version: 2024.04.01 08:59
Detils for [http://fedoraproject.org Fedora] version 11, 12 and 13 are at [http://fedoraproject.org/wiki/Features/TeXLive Fedora Project Wiki TeX Live page] maintained by Jindrich Novy. The repository provides a snapshot of TeX Live 2010 tlpretest, and it includes very new ConTeXt packages and requires absolutely no manual configuration to get working Mk II and Mk IV. Highly recommended.= Upgrade =
=== funtoo ===Re-run the install program to upgrade, which will update the distribution incrementally:
If you are using [http* Windows:<code>install.bat</code>* GNU/funtooLinux or macOS: <code>sh install.org funtoo] there are ebuilds that will make an installation as easy as installing any other package from portage. Take a look at the [[ConTeXt Standalone Funtoo]] Howto. This might also work for [http:sh<//www.gentoo.org gentoo], but is untested right now.code>
=== openSUSE ==First document =
OpenSUSE (starting from 10.3beta3) comes with TeX Live == Creation of a first ConTeXt file == Open a [[Text Editors|text editor]], type the following content, and offers also XeTeX. 10.3b3 contains ConTeXt 2007.01.12save the file as <code>doc01.tex</code>:
You can <texcode>\setuppapersize[A6]\starttext\startsection[http://software.opensuse.org/search?qtitle=context search for OpenSUSE packages online{Testing ConTeXt}]In OpenSUSE 11.3 there are two packages availableThis is my first ConTeXt document. * texlive-context-2010-33.1.noarch.rpm\stopsection\stoptext* texlive-context-2009-26.1.noarch.rpm</texcode>
=== freeBSD =Compilation of the ConTeXt file to PDF file ==
FreeBSD still relies on teTeX in Go to the ports collection. Alternately, TeXlive is now available as a branch extension, see [http://code.google.com/p/freebsdcommand-texlive/wiki/Installing] line and [httptype://romain.blogreen.org/blog/2011/08/texlive-2011-on-freebsd/], until migration to the main ports branch is completed.
[[TeX Live]] as a standalone installation will run "out of the box" on all recent versions of freeBSD (7, 8, 9) and extended support is available for earlier versions; The [[ConTeXt Standalone]] installation is compiled for the latest stable release (currently 8.2).<pre>context doc01</pre>
ConTeXt will then process your document, display some logging information on the console, and generate a <tt>doc01.pdf</tt> output file. <pre><nowiki>resolvers | formats | executing runner 'run luametatex format': /home/myuser/context/tex/texmf-linux-64/bin/luametatex --jobname="./doc01.tex" --socket --shell-escape --fmt=/home/myuser/context/tex/texmf-cache/luametatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luametatex/cont-en.fmt --lua= OpenBSD /home/myuser/context/tex/texmf-cache/luametatex-cache/context/5fe67e0bfe781ce0dde776fb1556f32e/formats/luametatex/cont-en.lui --c:currentrun=1 --c:fulljobname="./doc01.tex" --c:input="./doc01.tex" --c:kindofrun=1 --c:maxnofruns=9 --c:texmfbinpath="/home/myuser/context/tex/texmf-linux-64/bin"system > system > ConTeXt ver: 2024.04.01 08:59 LMTX fmt: 2024.4.13 int: english/englishsystem >
* [[OpenBSD installation|OpenBSD]]…
== Mac OS X ==mkiv lua stats > used engine: luametatex version: 2.11.02, functionality level: 20240311, format id: 700, compiler: gcc* [[Mac Installation]]mkiv lua stats > tex properties: 807100 hash slots used of 2097152, 51019 control sequences, approximate memory usage: 42 MBmkiv lua stats > lua properties: engine: lua 5.5, used memory: 57 MB, ctx: 54 MB, max: 54 MB, symbol mask: utf (τεχ)mkiv lua stats > runtime: 0.617 seconds, 1 processed pages, 1 shipped pages, 1.620 pages/secondsystem | total runtime: 1.989 seconds of 2.052 seconds</nowiki></pre>
== Windows Viewing the generated PDF file ==There are two main TeX distributions for Windows wich contain a stable context* [[MikTeX]] (currently '''ConTeXt support is broken''')* [[TeX Live]] (provides stable ConTeXt)
Use Open the generated <tt>doc01.pdf</tt> PDF file using a [[ConTeXt Standalone|ConTeXt Suite]http://en.wikipedia.org/wiki/List_of_PDF_software#Viewers PDF viewer], if you want up to date ConTeXt.It should look as follows:
* [<context force="yes">\setuppapersize[Windows InstallationA6]] ''(if you are also using LaTeX or have a favourite editor)''* [\starttext\startsection[Windows Installation: title={Testing ConTeXt Suite with SciTe}]] ''(the "for dummies" version for those who haven't done any TeXing before)''This is my first ConTeXt document.\stopsection\stoptext</context>
== Installation from source == * [[TeX Live | TeX Live installation]]: Specific installation instructions using Note that the TeX Live source distributionsection has been numbered, the section number and the section title appear in a slightly larger fonts.* [[Installation hints]]
Your installation is now up and running: you can start working on the [[Tutorials]].
=Additional instructions = external manuals on installation ==* [http://www.pragma-ade.com/general/manuals/minstall.pdf How to install context (outdated 2001)]
{{Installation navbox}}* [[Installing ConTeXt LMTX on MacOS]]* [[Modules#ConTeXt_LMTX|Installing Modules for ConTeXt LMTX]]* The official page '''[http://www.pragma-ade.nl/install.htm Installing ConTeXt LMTX ]''' is hosted by Pragma ADE.* Pragma ADE also provides the '''[http://www.pragma-ade.nl/download-1.htm ConTeXt MkIV distribution]''' (version MkIV is the predecessor of LMTX) for which there are also [[ConTeXt_Standalone|detailed installation instructions]].* Compilation with ConTeXt MkIV (old LuaTeX-based version): The new distribution has all the files to run the previous version of ConTeXt.** <code>context --luatex doc01</code>
{{Getting started navbox}}
[[Category:Basics]]
[[Category:Installation]]