open-collaboration-server
v0.2.0
Published
Open Collaboration Server implementation, part of the Open Collaboration Tools project
Downloads
11
Maintainers
Readme
Open Collaboration Server
Open Collaboration Tools is a collection of open source tools, libraries and extensions for live-sharing of IDE contents, designed to boost remote teamwork with open technologies. For more information about this project, please read the announcement.
This package is the server implementation for Open Collaboration Tools. All participants of a collaboration session must connect to the same server.
You can run this package directly or use the public container image oct-server. If you'd like to customize the server, use this package as a TypeScript library and build your own application.
The Public Instance
A public instance of this server is available at https://api.open-collab.tools/
, which is operated by TypeFox. TypeFox offers this service with the intent to demonstrate the capabilities of the project and to support open source communities with it. However, we recommend all companies who wish to adopt this technology to deploy their own instance of it, secured with their existing access restrictions.
Usage of the public instance is bound to its Terms of Use. Please read them carefully and use our Discussions for any questions.
Configuration
Environment variables
| Variable | Description | |--------------------|---| | OCT_SERVER_OWNER | Name of the server owner. E.g. the name of the company that hosts the server | | OCT_JWT_PRIVATE_KEY | The private key for encoding the JWT's used for authenticating users | | OCT_LOGIN_PAGE_URL | Url of the login page. Defaults to /login.html?token={token} | | OCT_LOGIN_SUCCESS_URL | Url of the login success page. Defaults a simple "Login Successful. You can close this page" text | | OCT_BASE_URL | Base URL of the server is reachable under. Used for oauth redirects | | OCT_ACTIVATE_SIMPLE_LOGIN | Activates the simple login handler to alow unverified authentication just with username and optionally email | | OCT_OAUTH_{Provider Name}CLIENTID | Sets the client id for the specified OAuth provider | | OCT_OAUTH{Provider Name}_CLIENTSECRET | Sets the client secret for the specified OAuth provider |