Rotimi Best
168866c81b
* chore: use turbo for build * fix docker compose file and remove backend * chore: update .dockerignore to include additional files and directories for improved build management * copy everything in both docke filed * refactor: streamline Dockerfile to copy entire dashboard app and remove unnecessary node_modules references * update api to use turbo to start * run ls la for docker files * update cmd commands * update cmds to use node * fix: add redis url to docker compose * fix: reduce memory allocation for dashboard build in Dockerfile * debug dashboard build * update api docker file * update dashboard * add tsconfig * chore: add echo to dockerfile * fix: change echo to run * chore: install pnpm before switching to non-root user in Dockerfile * refactor: update start commands in package.json and Dockerfiles to use pnpm * install turbo * use turbo 1.10.16 * update turbo config * fix: update CMD in Dockerfile to run the API directly using Node.js * change * add commands to turbo.json * copy over turbo * add workspace * fix: update start commands in package.json to specify ports for dashboard and API * publish docker images * add dev branch * update compose * build only for amd64 platform * refactor: update docker-compose to use pre-built images and remove build context * coolify-dockertest * point to latest * chore: update docker-compose to use specific version tags for API and dashboard images * remove envs for docker file * 0.1.3 * use dynamic env * 0.1.4 * add PUBLIC_IS_SELFHOSTED=true * chore: update docker-compose to use version 0.1.5 for API and dashboard images * use static for PUBLIC_IS_SELFHOSTED * disable cache for tag * use 0.1.7 * add PUBLIC_IS_SELFHOSTED=true * comment out caching * update docker-compose to use version 0.1.8 for API and dashboard images * update api port * use tag 0.1.9 * add cache * use latest tag in compose file
171 lines
4.9 KiB
Plaintext
171 lines
4.9 KiB
Plaintext
import Image from 'next/image';
|
||
import { Callout } from 'nextra/components';
|
||
import SelfhostClassroomIO from './images/selfhost-classroomio.webp';
|
||
|
||
# Self-hosting ClassroomIO.com
|
||
|
||
This guide will help you quickly selfhost ClassroomIO
|
||
|
||
<Image src={SelfhostClassroomIO} alt="Selfhost ClassroomIO" quality="100" />
|
||
|
||
ClassroomIO is made up of the following applications
|
||
|
||
- [apps/api](https://github.com/rotimi-best/classroomio/tree/main/apps/api) - an Express server
|
||
- [apps/dashboard](https://github.com/rotimi-best/classroomio/tree/main/apps/dashboard) - the admin dashboard + LMS
|
||
- [supabase](https://github.com/rotimi-best/classroomio/tree/main/supabase) - the database + REST API.
|
||
|
||
The quickest and easiest way to deploy both the api and dashboard is by using our [Railway Template](https://railway.app/template/dl9RG7?referralCode=8OyIj5). However there are a couple of things that you'd need first before heading over to the template, which are:
|
||
|
||
1. SMTP values - For sending emails on the api
|
||
2. Supabase - For the database used on the dashboard
|
||
3. Cloudflare R2 (optional) - Video uploads on the api
|
||
|
||
## SMTP Setup
|
||
|
||
Both for the supabase and api setup, you'd need a custom SMTP for email sending. Most importantly you need these values:
|
||
|
||
```bash
|
||
SMTP_HOST=
|
||
SMTP_PORT=
|
||
SMTP_USER=
|
||
SMTP_PASSWORD=
|
||
SMTP_SENDER=
|
||
```
|
||
|
||
Make sure you have them handy because you'd need them while we go through this selfhosting guide.
|
||
|
||
<Callout type="info" emoji="ℹ️">
|
||
Learn more about setting up a custom SMTP server
|
||
[here](https://supabase.com/docs/guides/auth/auth-smtp)
|
||
</Callout>
|
||
|
||
## Supabase
|
||
|
||
There are 2 options to go about setting up Supabase, you could [selfhost supabase](https://supabase.com/docs/guides/self-hosting) on your own servers or you could use their cloud version. We recommend you use the cloud version because it has a very generous free tier and you get to deploy it very quickly.
|
||
|
||
We have a standalone guide to help you setup your Supabase Cloud and you can find it [here](https://classroomio.com/docs/contributor-guides/supabase-cloud)
|
||
|
||
After you go through that guide you will need the following environment variables, please also store them somewhere:
|
||
|
||
```bash
|
||
PUBLIC_SUPABASE_URL=
|
||
PUBLIC_SUPABASE_ANON_KEY=
|
||
PRIVATE_SUPABASE_SERVICE_ROLE=
|
||
```
|
||
|
||
## Cloudflare R2
|
||
|
||
We use Cloudflare R2 for video uploading within the course builder. It is not required though and you can do without it in the app if you don't need video upload.
|
||
|
||
<Callout type="info" emoji="⏳">
|
||
This section is a work in progress.
|
||
</Callout>
|
||
|
||
## Deploy on Railway
|
||
|
||
Now you have everything you need and you are ready to deploy the api and dashboard.
|
||
|
||
Go ahead and click this button to get started.
|
||
|
||
[](https://railway.app/template/dl9RG7?referralCode=8OyIj5)
|
||
|
||
### Environment Variables.
|
||
|
||
#### cio-api
|
||
|
||
```bash
|
||
# Required
|
||
SMTP_HOST=""
|
||
SMTP_PORT=""
|
||
SMTP_USER=""
|
||
SMTP_SENDER=""
|
||
SMTP_PASSWORD=""
|
||
PUBLIC_SUPABASE_URL=""
|
||
PUBLIC_SUPABASE_ANON_KEY=""
|
||
|
||
# Optional
|
||
CLOUDFLARE_BUCKET_ID=""
|
||
CLOUDFLARE_ACCESS_KEY=""
|
||
CLOUDFLARE_ACCOUNT_ID=""
|
||
CLOUDFLARE_BUCKET_DOMAIN=""
|
||
CLOUDFLARE_SECRET_ACCESS_KEY=""
|
||
SENTRY_DNS=""
|
||
```
|
||
|
||
<Callout type="info" emoji="ℹ️">
|
||
Learn more about the environment variables
|
||
[here](https://github.com/rotimi-best/classroomio/blob/main/apps/api/.env.example)
|
||
</Callout>
|
||
|
||
#### cio-dashboard
|
||
|
||
```bash
|
||
# Required
|
||
PUBLIC_SUPABASE_URL=""
|
||
PUBLIC_SUPABASE_ANON_KEY=""
|
||
PRIVATE_SUPABASE_SERVICE_ROLE=""
|
||
PUBLIC_SERVER_URL=""
|
||
|
||
# Optional
|
||
OPENAI_API_KEY=""
|
||
PUBLIC_IP_REGISTRY_KEY=""
|
||
UNSPLASH_API_KEY=""
|
||
PRIVATE_APP_HOST=""
|
||
PRIVATE_APP_SUBDOMAINS=""
|
||
```
|
||
|
||
<Callout type="info" emoji="ℹ️">
|
||
Learn more about the environment variables
|
||
[here](https://github.com/rotimi-best/classroomio/blob/main/apps/dashboard/.env.example)
|
||
</Callout>
|
||
|
||
## Using Docker
|
||
|
||
We provide a docker-compose configuration to deploy both the api and dashboard services. Here's how to use it:
|
||
|
||
1. Clone the repository:
|
||
|
||
```bash
|
||
git clone https://github.com/rotimi-best/classroomio.git
|
||
cd classroomio
|
||
```
|
||
|
||
2. Create a `.env` file with your environment variables (see Environment Variables section above)
|
||
|
||
3. Start the services:
|
||
|
||
```bash
|
||
docker compose up --build
|
||
```
|
||
|
||
The services will be available at:
|
||
|
||
- Dashboard: http://localhost:3082
|
||
- Backend: http://localhost:3081
|
||
|
||
### Service Configuration
|
||
|
||
The docker-compose file sets up two services:
|
||
|
||
#### Backend Service
|
||
|
||
- Runs on port 3081
|
||
- Uses Node.js slim image
|
||
- Mounts the api code directory
|
||
- Requires environment variables for:
|
||
- Supabase configuration
|
||
- Cloudflare R2 for video uploads
|
||
- SMTP for email notifications
|
||
|
||
#### Dashboard Service
|
||
|
||
- Runs on port 3082
|
||
- Uses Node.js Alpine image
|
||
- Uses pnpm for package management
|
||
- Requires environment variables for:
|
||
- Supabase configuration
|
||
- Application settings
|
||
- Optional API keys (OpenAI, Unsplash)
|
||
|
||
Note: We're currently working on including Supabase in the docker-compose file. If you'd like to help with this, please open a PR on GitHub! 👍
|