Skip to content

Add self-hosting documentation and centralized cloud service configuration #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 6 commits into
base: main
Choose a base branch
from
Draft

Add self-hosting documentation and centralized cloud service configuration #1

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
bc51c7b
Initial plan
Copilot Jan 25, 2026
fe0408e
Add comprehensive self-hosting documentation
Copilot Jan 25, 2026
d0a3aac
Improve cloud service configuration with centralized config and logging
Copilot Jan 25, 2026
e6a38e6
Address code review feedback - improve import and clarify env var com…
Copilot Jan 25, 2026
a25715c
Final polish - clarify env var comments and fix whitespace
Copilot Jan 25, 2026
83b886c
Add detailed Roomote-only self-hosting implementation plan
Copilot Jan 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 18 additions & 2 deletions .env.sample
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,22 @@
# Analytics (Optional)
POSTHOG_API_KEY=key-goes-here

# Roo Code Cloud / Local Development
# Roo Code Cloud Configuration
# These environment variables allow you to use a self-hosted alternative to Roo Cloud.
# See SELF_HOSTING.md for detailed documentation on implementing your own cloud services.

# Authentication Service (Clerk-compatible OAuth provider)
# Default: https://clerk.roocode.com
# For development/self-hosted: Your Clerk instance or compatible OAuth service
CLERK_BASE_URL=https://epic-chamois-85.clerk.accounts.dev

# API Service (Main backend API)
# Default: https://app.roocode.com
# For development/self-hosted: Your API server URL
ROO_CODE_API_URL=http://localhost:3000
ROO_CODE_PROVIDER_URL=http://localhost:8080/proxy/v1

# Provider Proxy Service (OpenAI-compatible API endpoint)
# Default: https://api.roocode.com/proxy
# For development/self-hosted: Your provider proxy URL (e.g., http://localhost:8080/proxy)
# Note: Do not include /v1 suffix - it will be added automatically (e.g., /proxy becomes /proxy/v1)
ROO_CODE_PROVIDER_URL=http://localhost:8080/proxy
1 change: 1 addition & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,7 @@ Learn more: [Using Modes](https://docs.roocode.com/basic-usage/using-modes) •
## Resources

- **[Documentation](https://docs.roocode.com):** The official guide to installing, configuring, and mastering Roo Code.
- **[Self-Hosting Guide](SELF_HOSTING.md):** Learn how to replace Roo Cloud with your own self-hosted services.
- **[YouTube Channel](https://youtube.com/@roocodeyt?feature=shared):** Watch tutorials and see features in action.
- **[Discord Server](https://discord.gg/roocode):** Join the community for real-time help and discussion.
- **[Reddit Community](https://www.reddit.com/r/RooCode):** Share your experiences and see what others are building.
Expand Down
Loading