Go to the first, previous, next, last section, table of contents.


Simple installation

Installing TeX and friends for the first time can be a daunting experience. Thus, you may prefer to skip this whole thing and just get precompiled executables: see section `unixtex.ftp': Obtaining TeX.

This section explains what to do if you wish to take the defaults for everything (installing under `/usr/local'), and generally to install in the simplest possible way. Most steps here refer to corresponding subsection in the next section which explains how to override defaults and generally gives more details.

  1. Be sure you have enough disk space: approximately 8 megabytes for the compressed archives, 15MB for sources, 45MB for compilation, 40MB for the (initial) installed system (including library files). See section Disk space.
  2. Retrieve these two distribution archives:
    `ftp://ftp.tug.org/tex/texk.tar.gz'
    These are the sources, which you will be compiling.
    `ftp://ftp.tug.org/tex/texmflib.tar.gz'
    This is a basic set of input files. You should unpack it in the directory `/usr/local/share'; doing so will create a `texmf' subdirectory there.
    See section Kpathsea application distributions.
  3. When using the default search paths, there is no need to edit any distribution files. See section Changing search paths.
  4. At the top level of the distribution, run `sh configure'. (If you have the GNU Bash shell installed, run `bash configure'.) See section Running configure.
  5. `make'. See section Running make.
  6. `make install'. See section Installing files.
  7. `make distclean'. See section Cleaning up.
  8. Set up a cron job to rebuild the filename database that makes searching faster. This line will rebuild it every midnight:
    0 0 * * * cd /usr/local/share/texmf && /bindir/MakeTeXls-R
    
    See section Filename database generation, and section Filename database (ls-R).
  9. If you're installing Dvips, you also need to set up configuration files for your printers and make any additional PostScript fonts available. See section `Installation' in Dvips. If you have any color printers, see section `Color device configuration' in Dvips.
  10. The first time you run a DVI driver, a bunch of PK fonts will be built by Metafont via MakeTeXPK (and added to the filename database). This will take some time. Don't be alarmed; they will created only this first time (unless something is wrong with your path definitions). By default, MakeTeXPK assumes `/usr/local/share/texmf/fonts' is globally writable. If you need a different arrangement, see section `MakeTeX' configuration. See section `MakeTeX' scripts.
  11. For some simple tests, try `tex story \\bye' and `latex simple'. Then run `xdvi story' or `dvips simple' on the resulting DVI files to preview/print the documents. See section Installation testing.


Go to the first, previous, next, last section, table of contents.