First-time setup

Set up GradePush

A shared workspace for your institution, connected to GitHub.

Name your institution

Create the home for your teachers and their classes.
Create the GitHub App

We prepare the configuration. You confirm it on GitHub.
Sign in as administrator

Your GitHub account becomes the first administrator. You can then invite your colleagues.

Your institution

Institution name

GitHub App owner

One-time setup token

Use the token you set when deploying, or open your private setup link.

Where do I find my setup token?

Deployment secret

Set SETUP_TOKEN in your hosting provider’s secrets before starting GradePush, then enter the same value here. Use a random token of 32 to 128 characters without spaces.

Docker Compose

Generate a private setup link with this command:

docker compose exec app gradepush-setup

Open the link to fill in the token automatically.

Set up GradePush

Name your institution

Create the GitHub App

Sign in as administrator

Your institution

Deployment secret

Docker Compose