Account Setup & Permissions
To deploy websites, track your assignments, and participate in classroom activities, you need to set up your ClassHost account. This guide explains how ClassHost connects to third-party services and why specific permissions are required.
Authentication Methods
ClassHost supports two primary sign-in methods:
Sign In with Google
- Best for: Students who only need to join classrooms, view grades, or submit local ZIP files.
- Information accessed: ClassHost requests access to your basic profile (Name, email address, and avatar).
Sign In with GitHub (Recommended)
- Best for: Students who want to manage repositories, deploy files directly, edit code online, or use the Remix features.
- Information accessed: ClassHost requests access to your public profile and public repositories.
Installing the GitHub Integration App
Because ClassHost publishes websites directly to your personal GitHub account, you must authorize our GitHub App.
Step-by-Step Installation
1.
Navigate to the ClassHost Dashboard and click Connect GitHub Account.
2.
You will be redirected to the official GitHub integration page: github.com/apps/classhost.
3.
Choose whether to install the app on All Repositories or Only Select Repositories.
Choosing All Repositories is recommended for students, as it allows ClassHost to easily enable GitHub Pages, read template repos, and deploy remixes without requesting additional permission popups later.
4.
Click Install & Authorize.
5.
GitHub will redirect you back to ClassHost, and your account will show as Connected.
Permission Clarifications
We take your security very seriously. Here is an honest breakdown of the permissions requested by the ClassHost App:
| Scope | Permission Level | Why we need it |
|---|---|---|
| Repository Contents | Read & Write | To upload your HTML, CSS, and JS files, create files, and commit edits to your repositories. |
| GitHub Pages | Read & Write | To activate public hosting (.github.io) on your newly created web repositories. |
| Repository Metadata | Read Only | To list your existing repositories so you can deploy them directly. |
ClassHost will never request access to your private repositories, billing information, or security settings. We will never commit code without your explicit trigger via the web interface. All actions are initiated directly by your button taps.