user-docs issueshttps://gitlab.nic.cz/turris/user-docs/-/issues2023-08-29T11:09:44+02:00https://gitlab.nic.cz/turris/user-docs/-/issues/194Clarify kwboot2023-08-29T11:09:44+02:00Filip HronClarify kwbootCurrent description is too specific. Make it more unclear to avoid critique of former Turris team members.Current description is too specific. Make it more unclear to avoid critique of former Turris team members.Filip HronFilip Hronhttps://gitlab.nic.cz/turris/user-docs/-/issues/195Turris Mox USB (from module A) not working any more (for mass storage) after ...2023-05-18T13:38:03+02:00Lukas JelinekTurris Mox USB (from module A) not working any more (for mass storage) after TOS 6.0 upgrade - add to FAQAdd an item to the FAQ according this: https://forum.turris.cz/t/turris-mox-usb-from-module-a-not-working-any-more-for-mass-storage-after-tos-6-0-upgrade/17918/95Add an item to the FAQ according this: https://forum.turris.cz/t/turris-mox-usb-from-module-a-not-working-any-more-for-mass-storage-after-tos-6-0-upgrade/17918/95https://gitlab.nic.cz/turris/user-docs/-/issues/189Contact form for support2023-03-04T08:19:05+01:00Josef SchlehoferContact form for supportFor support purposes, we need to create and have contact form, which would help users and as well our support department to have many details as possible.
Users should provide: their name, email address (where to reach them)
Users shou...For support purposes, we need to create and have contact form, which would help users and as well our support department to have many details as possible.
Users should provide: their name, email address (where to reach them)
Users should be able to choose:
- Which router do they have
- Which version of OS do they have
- Which SN do they have (optional)
- Which problem do they have
- Upload diagnostics, if possible
and many more...
It should be here: https://docs.turris.cz/basics/support/https://gitlab.nic.cz/turris/user-docs/-/issues/193Updated MOX product brochure2023-03-02T09:03:33+01:00Filip HronUpdated MOX product brochurefollows #192
Upload updated MOX Brochure to reflect new Wi-Fi 6 card and deprecated SDIO.follows #192
Upload updated MOX Brochure to reflect new Wi-Fi 6 card and deprecated SDIO.Filip HronFilip Hronhttps://gitlab.nic.cz/turris/user-docs/-/issues/191Explicitly discourage users from sharing diagnostics output publicly2023-01-17T18:10:12+01:00Simon BorekExplicitly discourage users from sharing diagnostics output publiclyIn [Formulating your problem section of Getting Help documentation page](https://docs.turris.cz/basics/support/#formulating-your-problem) there is stated: "If you have logs, include them. But be aware that those __might contain sensitiv...In [Formulating your problem section of Getting Help documentation page](https://docs.turris.cz/basics/support/#formulating-your-problem) there is stated: "If you have logs, include them. But be aware that those __might contain sensitive data__."
As logs are listed as one of the diagnostics modules, it is technically clear the warning applies to them as well, but in practice users shouldn't be required to come to that conclusion themselves.
It might be highly beneficial to add a similar warning addressing diagnostics directly while being placed in an actual warning frame instead of being included as a part of text.
Related: https://gitlab.nic.cz/turris/reforis/reforis-diagnostics/-/issues/9https://gitlab.nic.cz/turris/user-docs/-/issues/186Support: mention Minimal Snapshot Manager and Diagnostics page2023-01-11T13:41:16+01:00Josef SchlehoferSupport: mention Minimal Snapshot Manager and Diagnostics pagehttps://gitlab.nic.cz/turris/user-docs/-/issues/165Rainbow and LEDs signaling2022-11-07T14:17:08+01:00Karel KociRainbow and LEDs signaling* [ ] documentation for `rainbow` command line tool and its configuration (in the future hopefully about reForis plugin as well)
* [ ] documentation about LEDs signaling for every board
Note that boards use LEDS to signal boot process a...* [ ] documentation for `rainbow` command line tool and its configuration (in the future hopefully about reForis plugin as well)
* [ ] documentation about LEDs signaling for every board
Note that boards use LEDS to signal boot process as well as hardware failures. With turris/os/packages!846 we also plan to signal running update and notifications.https://gitlab.nic.cz/turris/user-docs/-/issues/49Polish changelog page2022-11-07T11:27:41+01:00Michal HruseckyPolish changelog pageWould be nice if Changelog page would be somehow nicer - better formatted, links in right navigation bar and such.Would be nice if Changelog page would be somehow nicer - better formatted, links in right navigation bar and such.https://gitlab.nic.cz/turris/user-docs/-/issues/182MOX A USB port does not support hub - should be mentioned2022-10-24T12:28:19+02:00Stepan RechnerMOX A USB port does not support hub - should be mentionedAt the [Turris MOX A site](https://docs.turris.cz/hw/mox/modules/a/) in the documentation, it is mentioned among other specifications:
> - USB 3.0 port
But it is not mentioned, that a USB hub inserted in it would not work. Nevertheless...At the [Turris MOX A site](https://docs.turris.cz/hw/mox/modules/a/) in the documentation, it is mentioned among other specifications:
> - USB 3.0 port
But it is not mentioned, that a USB hub inserted in it would not work. Nevertheless, users may expect that. It should be probably mentioned there.
A side note: another description of Turris MOX A is at the website <https://www.turris.cz/cs/mox/moduly/>.
cc: @prohar @dmelinhttps://gitlab.nic.cz/turris/user-docs/-/issues/183Info about the need of a restart when SFP is plugged in is missing2022-10-24T12:28:17+02:00Stepan RechnerInfo about the need of a restart when SFP is plugged in is missingIn a Turris Omnia router, since Turris OS 4, the SFP port is not plug-and-play. It should be mentioned [in the documentation](https://docs.turris.cz/hw/omnia/omnia/#network-interfaces) that a restart of the router is required.In a Turris Omnia router, since Turris OS 4, the SFP port is not plug-and-play. It should be mentioned [in the documentation](https://docs.turris.cz/hw/omnia/omnia/#network-interfaces) that a restart of the router is required.https://gitlab.nic.cz/turris/user-docs/-/issues/126Document extra tarball feature2022-10-17T21:48:42+02:00Vojtech MyslivecDocument extra tarball featureFollow-up from https://gitlab.nic.cz/turris/turris-os-packages/-/merge_requests/564#note_178120
`rescue-image` package now supports extra tarball with initial configuration. We should document this feature somewhere.Follow-up from https://gitlab.nic.cz/turris/turris-os-packages/-/merge_requests/564#note_178120
`rescue-image` package now supports extra tarball with initial configuration. We should document this feature somewhere.Turris OS 6.0Michal HruseckyMichal Hruseckyhttps://gitlab.nic.cz/turris/user-docs/-/issues/185Add to Erratum issue with Google Chrome that connection test does not work2022-10-14T19:21:26+02:00Josef SchlehoferAdd to Erratum issue with Google Chrome that connection test does not workRelated to https://gitlab.nic.cz/turris/reforis/reforis/-/issues/387
I don't think there is anything related what we can do about that, so we should add this to Erratum to let users know about that.Related to https://gitlab.nic.cz/turris/reforis/reforis/-/issues/387
I don't think there is anything related what we can do about that, so we should add this to Erratum to let users know about that.Turris OS 6.0Aleksandr GumroianAleksandr Gumroianhttps://gitlab.nic.cz/turris/user-docs/-/issues/184Revisit Nextcloud article2022-10-10T17:05:46+02:00Josef SchlehoferRevisit Nextcloud articleForis is not going to be anymore with us since version Turris OS 6.0, we should revisit the article for Nextcloud as @agumroian took the iniciative and thanks to him, we have Nextcloud integration in reForis.
- [x] Replace Foris by reFo...Foris is not going to be anymore with us since version Turris OS 6.0, we should revisit the article for Nextcloud as @agumroian took the iniciative and thanks to him, we have Nextcloud integration in reForis.
- [x] Replace Foris by reForis
- [x] Make and upload new screenshot of reForis
This fixes: https://forum.turris.cz/t/cant-find-nextcloud-in-storage-on-reforis/17638/Turris OS 6.0Aleksandr GumroianAleksandr Gumroianhttps://gitlab.nic.cz/turris/user-docs/-/issues/167Command turris-diagnostics is not present on older version of Turris OS2022-08-24T10:54:33+02:00Josef SchlehoferCommand turris-diagnostics is not present on older version of Turris OSImagine what situation which I dealt with in our support department. You bought the router, and it had a factory version. It could be 4.0.1 and Foris does not work. The user found encouragement to SSH to his router, and the script is not...Imagine what situation which I dealt with in our support department. You bought the router, and it had a factory version. It could be 4.0.1 and Foris does not work. The user found encouragement to SSH to his router, and the script is not there.
We should somehow mention our documentation or provide more ways to get diagnostics from SSH. @srechner would you like to write a few rows to our documentation about it?https://gitlab.nic.cz/turris/user-docs/-/issues/23Explain updates from end users point of view2022-06-06T14:27:43+02:00Michal HruseckyExplain updates from end users point of viewExplain why updates are important, what updater and it's settings does and probably also LuCI package installation in advance section and how it is affected by updater.
This could be also used for **Singapore Cybersecurity Labelling Sch...Explain why updates are important, what updater and it's settings does and probably also LuCI package installation in advance section and how it is affected by updater.
This could be also used for **Singapore Cybersecurity Labelling Scheme** (https://gitlab.nic.cz/turris/biz/singapore-certification/-/issues/1). To meet the requirements of this scheme, we have to somehow address the following topic
* 5.3-2: When the device is not a constrained device, it shall have an update mechanism for the secure installation of updates.
* 5.3-3: An update shall be simple for the user to apply.
* 5.3-7: The device shall use **best practice cryptography** to facilitate secure update mechanisms.
* 5.3-8: **Security updates shall be timely.**
* 5.3-10: Where updates are delivered over a network interface, the device shall **verify the authenticity and integrity of each update via a trust relationship.**
Also, there should be some description of updater **threat model** (For example something similar to "1.5.2. from Goals to protect against specific attacks" https://github.com/theupdateframework/specification/blob/master/tuf-spec.md#the-update-framework-specification)Basics2020-10-16https://gitlab.nic.cz/turris/user-docs/-/issues/24Explain updater internals2022-06-06T14:27:38+02:00Michal HruseckyExplain updater internalsExplain how configuration works, how to override stuff and few main advanced features that might be interesting for advance users.Explain how configuration works, how to override stuff and few main advanced features that might be interesting for advance users.Basicshttps://gitlab.nic.cz/turris/user-docs/-/issues/68Turris OS UCI configuration reference2022-06-06T14:20:03+02:00Karel KociTurris OS UCI configuration referenceThis should be reference table of all possible UCI configurations with use cases and intended purposes we added to OpenWrt. We could even document some of the OpenWrt stuff we touch in Foris and other components. We do not have to docume...This should be reference table of all possible UCI configurations with use cases and intended purposes we added to OpenWrt. We could even document some of the OpenWrt stuff we touch in Foris and other components. We do not have to document every single option in UCI but having table for our extensions makes sense. I am not sure if OpenWrt has some generic sheet about that (they have for example this https://openwrt.org/docs/guide-user/base-system/basic-networking - see tables in that wiki) but we can build on top of that.https://gitlab.nic.cz/turris/user-docs/-/issues/178Feature request: provide steps to boot from SSD without working system2022-05-10T13:23:10+02:00Josef SchlehoferFeature request: provide steps to boot from SSD without working systemHey there,
I noticed that I am not able to use steps given in **Preparation of SSD**, they assume that I have working system (with functional eMMC). That's wrong in my case. Most people will be looking into it when they worn-out their i...Hey there,
I noticed that I am not able to use steps given in **Preparation of SSD**, they assume that I have working system (with functional eMMC). That's wrong in my case. Most people will be looking into it when they worn-out their internal storage.
My u-boot version: ``U-Boot 2019.07 (Oct 05 2020 - 23:50:39 +0000), Build: jenkins-turris-os-packages-dragons-omnia-1753``.
When I selected 7 (``run rescueboot`` does not work], I am able to use steps given in our old documentation, these days, community one: https://wiki.turris.cz/doc/en/howto/omnia_booting_from_external_storagehttps://gitlab.nic.cz/turris/user-docs/-/issues/161Link(s) to versions in changelog recognized as incorrect2022-03-17T17:34:16+01:00Lukas JelinekLink(s) to versions in changelog recognized as incorrectThe remote link checker recognizes links to Turris OS versions in the changelog as incorrect. This is because these links are build in JavaScript and the file itself contains only a template for these links.
We should modify the checker...The remote link checker recognizes links to Turris OS versions in the changelog as incorrect. This is because these links are build in JavaScript and the file itself contains only a template for these links.
We should modify the checker and/or the changelog to drop this false positive warning.https://gitlab.nic.cz/turris/user-docs/-/issues/171Update VLAN documentation for OpenWrt 21.022022-02-21T16:59:40+01:00Karel KociUpdate VLAN documentation for OpenWrt 21.02In reference of changes handled in turris/os/build#273 we should update VLAN configuration.In reference of changes handled in turris/os/build#273 we should update VLAN configuration.