For complete documentation visit tinkerbell.org

Tinkerbell is a bare metal provisioning engine. It’s built and maintained with love by the team at Equinix Metal.

This repository is Experimental meaning that it's based on untested ideas or techniques and not yet established or finalized or involves a radically new and innovative style! This means that support is best effort (at best!) and we strongly encourage you to NOT use this in production.

This website uses Hugo to generate static HTML pages. It's hosted and automatically build by Netlify (see netlify.toml for more details).

• content/ directory contains documentation files
• config.toml is the Hugo configuration
• netlify.toml is Netlify configuration

Make sure you have installed Hugo on your system. Follow the instructions to clone this repository and build the docs locally.

• Clone the repository

git clone https://github.com/tinkerbell/tinkerbell.org
cd tinkerbell.org

• Fetch the theme submodule

git submodule update --init --recursive

• Start local server

hugo server -D

Site can be viewed at http://localhost:1313

• Run npm insall

npm install

• Development

npm run watch

• Production

npm run production

# example: adding new documentation page under section
hugo new section/name-of-new-page.md

Find the documentation page file (.md file) under content/ and edit it.

Create a Pull Request with your changes. When the PR is merged site will be updated automatically by Netlify.

The code snippets and the documentation is licensed under Apache license. See LICENSE for the full license text.