occweb/README.md

25 lines
1.2 KiB
Markdown
Raw Normal View History

# ⚠️ Deprecated ⚠️ OCCWeb terminal
2019-01-19 20:00:53 +00:00
2019-01-21 17:27:30 +00:00
### A web terminal for admins to launch Nextcloud's occ commands
2019-01-19 20:00:53 +00:00
2019-01-21 17:27:30 +00:00
![occweb](https://git.adphi.net/Adphi/OCCWeb/raw/master/appinfo/screenshot.png)
## ⚠️ Deprecated ⚠️
2020-06-20 01:59:38 +00:00
As nextcloudd has no native support for asynchronous operations, due to the use of php, this aplication is deprecated, and will no longer support the Nextcloud' future versions (19+). I did not find a way to implemement true support for interactive and long running occ tasks in a web terminal whitout introducing addtional dependencies (through websockets, for example), the lack of true asynchronous occ operations can lead to serious alterations of voluminous instances.
2020-06-20 01:44:49 +00:00
[This issue](https://github.com/nextcloud/server/issues/16726) may give some hints on why I decided to not support this application anymore.
2020-01-29 21:03:47 +00:00
## Install
2019-01-19 20:00:53 +00:00
Place this app in **nextcloud/apps/**
2020-01-29 21:03:47 +00:00
## ⚠️ Warnings ⚠️
2020-01-29 21:03:47 +00:00
- The application is not a real interactive terminal and does not support long running tasks.
So if your instance is pretty big, commands like `occ files:scan` will time out and fail.
2020-06-20 01:44:49 +00:00
- Do not use `occ maintenance:mode --on`, obvious...
2020-01-29 21:03:47 +00:00
## TODOs:
See [open issues](https://git.adphi.net/Adphi/OCCWeb/issues)