This is a curated list of frequently asked questions.
Q: What is this ?
OS.js is a free and open-source cloud/web desktop platform.
It serves web applications in an interface familiar to most desktop users.
Q: How do I get support ?
Send an email to email@example.com or check out the following links.
Q: How do I report a bug or feature requests ?
The best way is to create an issue on Github. Read this issue for more information.
You can also contact me via methods listed above, but an issue is preferred.
Q: How can I get started with development ?
Most of the articles assume you at least have basic understanding of these.
If you still have questions, head into the chatroom.
Q: How do I contribute ?
See the following resources:
Q: How do I perform installation on windows ?
Using windows explorer, enter the OS.js installation directory and press
ALT+D, then type
powershell and press
Q: Can I make changes to your software ?
Yes. This project is open-source and licensed under BSD-2-clause which allows you to modify and distribute the software.
If you want to contribute changes back to the community, look at "How do I contribute" above.
Q: How do I add login ?
By default OS.js is set up to automatically log in with a "demo" user and a dummy authentication adapter.
Q: Can I add feature X or application Y ?
Anything that can use these technologies can technically run on this platform.
Q: How do I add an existing web application ?
This way you can leave your entire codebase intact and just load it as you would normally, but within a Window.
Apps hosted outside OS.js
An example on how to display an already running separate application:
This file is a modified version of what
npm run make:applicationcreates.
Hosted within OS.js
See the IFrames tutorial.
Q: Can I upgrade from v2 ?
No. OS.js v3 is not compatible with the v2 APIs.
If you developed your v2 applications using IFrames or custom frameworks, transitioning to v3 is possible.
Q: Is there a matrix channel ?
Yes. There's an unofficial resource for this:
https://matrix.to/#/!lxLFDpQJHZtqePeIUK:matrix.org?via=matrix.org - Matrix channel linked to Gitter. Users without Github accounts can use this service as an alternative with a client like https://riot.im/app.