Welcome to the Octez and Protocol Documentation!

To start browsing, either follow one of the guided paths below, or directly pick any topics in the documentation menu.

Discover Octez & the Tezos protocol

Never heard of Octez? Let’s get acquainted!

Octez & the Tezos protocol are an implementation of the Tezos blockchain , a distributed consensus platform with meta-consensus capability.

This means that, unlike other blockchains like Bitcoin or Ethereum, Tezos comes to consensus not only about the state of its ledger, but also about how the protocol and the nodes should adapt and upgrade.

This is a fundamental design choice, allowing Tezos to be seamlessly upgradable and continuously evolving. Due to this feature, Tezos is built to last, and always stay at the leading edge of blockchain technology.

To learn more about Tezos, see <https://tezos.com>.

To learn more about how Octez & the protocol fit into Tezos and its ecosystem, see Octez & Protocol overview.

Getting started

Newcomer to Octez? Start participating in Tezos using Octez!

Start participating in Tezos by following the Introduction section in the documentation menu.

These tutorials explain:

and more.

Using Octez

Already a user? Here is everything you need to know!

If you already installed Octez and can participate in the Tezos blockchain, the most useful resources are grouped in the User manual section in the documentation menu. These pages:

If you intend to participate to Tezos not just as a user, but rather as a baker, you should also check more specialized documentation such as the Baking section on Open Tezos.


Want to know how it works? It’s no secret, let us explain!

If you want to know more about the technology underlying Octez and the Tezos protocol, the Reference manual section in the documentation present their rationale, main design principles, and some high-level implementation principles:

Developer reference

Are you a Tezos developer? Find here some useful reference pages!

If you are a developer on the Tezos platform, you must know the Tezos Developer Portal or Open Tezos, giving accessible and pedagogical expositions on how to write smart contracts or Dapps.

This website complements those resources with reference documentation, mostly in section Developer reference, including:


Are you a platform developer? Here are the nuts and bolts!

One major focus of this website is on resources for platform developers, that is, contributors to Octez (Octez developers) and contributors to the Tezos protocol (protocol developers).

Platform developers can find a rich set of explanations, tutorials, and howtos, mainly in the Contributing section, including:

Platform developers are also provided reference materials for internal APIs of Octez, such as: