Take the 2-minute tour ×
TeX - LaTeX Stack Exchange is a question and answer site for users of TeX, LaTeX, ConTeXt, and related typesetting systems. It's 100% free, no registration required.


I have a .cls file that I would like pdflatex to use. I have read the following

I am using TeX Live 2012, installed into /usr/local/texlive/.

I would like to install the .cls file into $HOME/.texmf (or some other non-standard directory), rather than $HOME/texmf. I thought this would be:

mkdir $HOME/.texmf
initexmf --register-root=$HOME/.texmf
sudo /usr/local/texlive/2012/bin/x86_64-linux/tlmgr conf texmf TEXMFHOME $HOME/.texmf
mv amazingbook.cls $HOME/.texmf
latex amazing-stories-1.tex


The initexmf program does not exist (in TeX Live 2012). I have read that the mktexlsr command is equivalent to initexmf.



mktexlsr $HOME/.texmf
mv amazingbook.cls $HOME/.texmf
mktexlsr $HOME/.texmf

The .cls file cannot be found when running:

pdflatex amazing-stories-1.tex


What are the exact steps necessary to install a custom .cls file into a given directory and configure the environment so that the .cls file is visible from LaTeX using TeX Live 2012?

share|improve this question
AFAIK initexmf is MikTeX-specific; MikTeX can easily handle many texmf trees. –  Martin Schröder Feb 6 '13 at 10:34
initexmf is a multi-purpose tool. initexmf --update is the equivalent to mktexlsr, but initexmf --register-root is a (wonderful) miktex specific feature. –  Ulrike Fischer Feb 6 '13 at 13:50

1 Answer 1

up vote 7 down vote accepted

The following commands create the required directory hierarchy and register the .cls file:

mkdir -p $HOME/.texmf/tex/latex/amazing
sudo /usr/local/texlive/2012/bin/x86_64-linux/tlmgr conf texmf TEXMFHOME $HOME/.texmf
mv amazingbook.cls $HOME/.texmf/tex/latex/amazing
mktexlsr $HOME/.texmf
latex amazing-stories-1.tex

The pdflatex command can now find amazingbook.cls.

share|improve this answer

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.