Installation troubleshooting

This page groups information about known problems when installing Tezos (more precisely, the “Octez” implementation of Tezos software). The different issues and their solutions are grouped per installation method, except for generic issues concerning all installation scenarios.

This page lists only the most frequent problems. If you don’t find your problem in this page, chances are that the problem is too specific. Consult the Tezos community (e.g. the Tezos Stack Exchange) to see if others have encountered a similar problem, and whether a solution is known.

Generic issues


Compiling the sources

These issues concern installing by compiling the sources.

Currently, the CONFIG_SITE environment variable must not be set during the installation process, or the stdcompat package may be installed incorrectly. See thierry-martinez/stdcompat#13.