mirror of
https://github.com/rzmk/learnhouse.git
synced 2025-12-19 04:19:25 +00:00
Added Coolify related docker files
This commit is contained in:
parent
98dfad76aa
commit
f73fc4b4c4
3 changed files with 277 additions and 0 deletions
100
README_Coolify.md
Normal file
100
README_Coolify.md
Normal file
|
|
@ -0,0 +1,100 @@
|
|||
# LearnHouse Deployment Guide for Coolify
|
||||
|
||||
This document provides instructions for deploying LearnHouse using Coolify, ensuring proper configuration and persistent storage.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- A Coolify instance up and running
|
||||
- Access to the LearnHouse GitHub repository
|
||||
- Domain name for your LearnHouse instance
|
||||
- Email provider credentials (if using email functionality)
|
||||
|
||||
## Deployment Steps
|
||||
|
||||
### 1. Create a New Resource in Coolify
|
||||
|
||||
- Log in to your Coolify dashboard
|
||||
- Click on "Create Resource"
|
||||
- Select "GitHub Repository" as the source
|
||||
|
||||
### 2. Configure Docker Compose Build
|
||||
|
||||
- Select "Docker Compose" as the build method
|
||||
- Choose `docker-compose-coolify.yml` as the compose file
|
||||
- Make sure the "Volume" configuration is set to store persistent data
|
||||
|
||||
### 3. Configure Domain Settings
|
||||
|
||||
- Add your domain (e.g., `learnhouse.example.com`) in the resource settings
|
||||
- Enable HTTPS if needed (recommended for production)
|
||||
- Configure any necessary redirects
|
||||
|
||||
### 4. Environment Variables
|
||||
|
||||
Add the following environment variables. Replace placeholder values with your actual configuration:
|
||||
|
||||
```
|
||||
# LearnHouse Core Configuration
|
||||
LEARNHOUSE_SITE_NAME=Your LMS Name
|
||||
LEARNHOUSE_SITE_DESCRIPTION=Your platform description
|
||||
LEARNHOUSE_SELF_HOSTED=true
|
||||
LEARNHOUSE_SSL=true
|
||||
LEARNHOUSE_CONTACT_EMAIL=contact@example.com
|
||||
|
||||
# Domain Configuration
|
||||
NEXT_PUBLIC_LEARNHOUSE_DOMAIN=learnhouse.example.com
|
||||
LEARNHOUSE_COOKIE_DOMAIN=learnhouse.example.com
|
||||
NEXT_PUBLIC_LEARNHOUSE_TOP_DOMAIN=learnhouse.example.com
|
||||
|
||||
# Authentication
|
||||
NEXTAUTH_SECRET=your_generated_secret_key
|
||||
NEXTAUTH_URL=https://learnhouse.example.com
|
||||
|
||||
# API URLs
|
||||
NEXT_PUBLIC_API_URL=https://learnhouse.example.com/api/v1/
|
||||
NEXT_PUBLIC_LEARNHOUSE_API_URL=https://learnhouse.example.com/api/v1/
|
||||
NEXT_PUBLIC_LEARNHOUSE_BACKEND_URL=https://learnhouse.example.com/
|
||||
|
||||
# Organization Settings
|
||||
NEXT_PUBLIC_LEARNHOUSE_MULTI_ORG=false
|
||||
NEXT_PUBLIC_LEARNHOUSE_DEFAULT_ORG=default
|
||||
|
||||
# Database Configuration
|
||||
POSTGRES_USER=learnhouse
|
||||
POSTGRES_PASSWORD=strong_database_password
|
||||
POSTGRES_DB=learnhouse
|
||||
LEARNHOUSE_SQL_CONNECTION_STRING=postgresql://learnhouse:strong_database_password@db:5432/learnhouse
|
||||
|
||||
# Redis Configuration
|
||||
REDIS_PASSWORD=strong_redis_password
|
||||
LEARNHOUSE_REDIS_CONNECTION_STRING=redis://default:strong_redis_password@redis:6379/learnhouse
|
||||
|
||||
# ChromaDB Configuration
|
||||
LEARNHOUSE_CHROMADB_HOST=chromadb
|
||||
|
||||
# Email Configuration (optional)
|
||||
LEARNHOUSE_EMAIL_PROVIDER=resend
|
||||
LEARNHOUSE_RESEND_API_KEY=re_your_resend_api_key
|
||||
```
|
||||
|
||||
### 5. Start the Build Process
|
||||
|
||||
- Click on "Deploy" to start the build and deployment process
|
||||
- Monitor the build logs for any errors
|
||||
- Once complete, verify that your LearnHouse instance is accessible at your domain
|
||||
|
||||
### 6. Verify Persistent Storage
|
||||
|
||||
- After deployment, upload some content (course materials, organization logos, etc.)
|
||||
- Restart the service to confirm that uploaded files persist across restarts
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
- **File uploads not persisting**: Ensure the volume mount in `docker-compose-coolify.yml` points to `/app/api/content` which is where the application stores uploaded files.
|
||||
- **Database connection errors**: Verify the database credentials and connection string.
|
||||
- **UI rendering issues**: Check that all Next.js related environment variables are correctly set.
|
||||
|
||||
## Additional Resources
|
||||
|
||||
- [LearnHouse Documentation](https://docs.learnhouse.io/)
|
||||
- [Coolify Documentation](https://coolify.io/docs)
|
||||
Loading…
Add table
Add a link
Reference in a new issue