Self Host Blocks Manual

Version 0.0.1


Table of Contents

Preface
Usage
Services
Contracts
Blocks
Demos
Contributing
A. All Options

Preface

Note

Self Host Blocks is hosted on GitHub. If you encounter problems or bugs then please report them on the issue tracker.

Feel free to join the dedicated Matrix room matrix.org#selfhostblocks.

Self Host Blocks intends to help you self host any service you would like with best practices out of the box.

To achieve this, Self Host Blocks provides building blocks which each provide part of what a self hosted app should do (SSO, HTTPS, etc.). It also provides some services that are already integrated with all those building blocks.

  • You are new to self hosting and want pre-configured services to deploy easily. Look at the services section.

  • You are a seasoned self-hoster but want to enhance some services you deploy already. Go to the blocks section.

  • You are a user of Self Host Blocks but would like to use your own implementation for a block. Head over to the matrix channel (the manual for this is WIP).

Self Host Blocks uses the full power of NixOS modules to achieve these goals. Blocks and service are both NixOS modules.