Setup Guide

The goal of this document is to help you create your own production instance of toolhub to be able to utilize it in your own space.

This document is still a WIP.

Authentication options

We currently use slack as our makerspace's main communication channel. The configuration option exists to enable this slack auth integration to authorize users based on channel subscriptions.

Adding the environment variables below to your .dockerenv will turn on both regular password and slack auth.

USE_ALLAUTH=true
ALLAUTH_PROVIDERS=allauth.socialaccount.providers.slack
TOOLHUB={'auth': {'use_allauth': True, 'use_password_auth': True, 'slack': {'required_group': 'members'}}}

In this case the member channel subscription enables the users to access toolhub.

Then add a new social app with your slack client keys in the django admin: https://<your site>/admin/socialaccount/socialapp/add/

Visit the login page for toolhub and try out the integration!