vscode-app/DESCRIPTION.md

39 lines
1.3 KiB
Markdown

## VS Code
Run VS Code on any machine anywhere and access it in the browser.
This app packages code-server (https://github.com/cdr/code-server),
a Visual Studio Code version that runs directly in the browser.
The app comes with very little adaptations to code-server:
* Move all vscode folders to /app/data/vscode
* Listen on 0.0.0.0:8080
* Generate a randomized password on first start (similar to code-server)
* Print passwort to logs on each start
* Use original VS code icon as favicon
* Optional Cloudron SSO integration
* Enable sudo
* TCP/UDP Development Port
* Script to run chroot'ed Alpine Linux
### Changing the password (only for custom auth)
The password is configured in `/app/data/vscode/config/config.yaml`.
You can change it by modifying the `password` key.
Also you can set the `hashed-password` key (create it) to the SHA-256 checksum
of a password (This setting takes precedence over `password`).
After changing the password (either way), the app has to be restarted.
### Installing additional software
There are two ways to install required additional software:
1. You can install software into the home folder of the current user. This works for a lot of tools like NodeJS or Rust.
2. You can download an image of a full OS (e.g. Alpine Linux) and work inside it using chroot. See `chroot-alpine`.