user-docs issueshttps://gitlab.nic.cz/turris/user-docs/-/issues2021-10-15T13:23:22+02:00https://gitlab.nic.cz/turris/user-docs/-/issues/154FAQ: Packages are missing or conflict new/existing file2021-10-15T13:23:22+02:00Josef SchlehoferFAQ: Packages are missing or conflict new/existing fileUsers are sometimes confused what to do if they receive some kind of notification:
```
inconsistent: Requested package python3-tornado that is not available.
```
It would be good, if we have some page tips&tricks or faq or updater page,...Users are sometimes confused what to do if they receive some kind of notification:
```
inconsistent: Requested package python3-tornado that is not available.
```
It would be good, if we have some page tips&tricks or faq or updater page, when we are going to tell why it happened (just basics), but most important that they need to remove it themselves, if they installed the package.
Because Update can not proceed otherwise. It could be good that we also say that it it nice to have email notifications enabled.
Then, we need to also something regarding collisions like this
```
• /usr/sbin/openvpn: openvpn-openssl (new-file), openvpn-mbedtls (existing-file)
```
In most cases, it is OK to remove one of the packages which it wants to install.
Could be connected to https://gitlab.nic.cz/turris/user-docs/-/issues/24https://gitlab.nic.cz/turris/user-docs/-/issues/153Add Errata how you can update your router from 4.0-beta (factory)2021-07-28T14:45:41+02:00Josef SchlehoferAdd Errata how you can update your router from 4.0-beta (factory)It would be nice, if we can document in our documentation in FAQ or in Erratum that once users unbox their router and plug them to the Internet, then they should not check any package lists before they are updated to the latest version.
...It would be nice, if we can document in our documentation in FAQ or in Erratum that once users unbox their router and plug them to the Internet, then they should not check any package lists before they are updated to the latest version.
This will prevent threads on our forum like this:
- https://forum.turris.cz/t/aktualizace-mox-4-0-beta/15581/3
- https://forum.turris.cz/t/runtime-string-requests-string-utils-uri-download-failed-the-requested-url-returned-error-404-not-found/14465?u=pepe
Related to https://gitlab.nic.cz/turris/os/build/-/issues/192#note_176493https://gitlab.nic.cz/turris/user-docs/-/issues/150Add information about checking RAID health2021-06-08T18:52:20+02:00Lukas JelinekAdd information about checking RAID healthOriginally from this support ticket: https://tracker.nic.cz/Ticket/Display.html?id=1334688
The documentation page about the reForis storage plugin should contain information how to check RAID disks health.Originally from this support ticket: https://tracker.nic.cz/Ticket/Display.html?id=1334688
The documentation page about the reForis storage plugin should contain information how to check RAID disks health.https://gitlab.nic.cz/turris/user-docs/-/issues/148Describe way how it is possible to verify medkit signature2021-09-21T16:07:26+02:00Josef SchlehoferDescribe way how it is possible to verify medkit signatureIn documentation, we have described how we can verify checksum for medkit, but we need to provide way to geeks how they can verify medkit's signature by using ``signify`` tool.In documentation, we have described how we can verify checksum for medkit, but we need to provide way to geeks how they can verify medkit's signature by using ``signify`` tool.https://gitlab.nic.cz/turris/user-docs/-/issues/147Add how to report Unknown API error in reForis2024-03-27T13:02:58+01:00Josef SchlehoferAdd how to report Unknown API error in reForisWe need to have article, where we will explain which steps are required to have stack trace from foris-controller, so we can fix this like, where to find web developer console in browser, how to get the stack trace and so on.
On our for...We need to have article, where we will explain which steps are required to have stack trace from foris-controller, so we can fix this like, where to find web developer console in browser, how to get the stack trace and so on.
On our forum, I wrote it several times, so at least there is some idea.Aleksandr GumroianAleksandr Gumroianhttps://gitlab.nic.cz/turris/user-docs/-/issues/146Add section about updater download error to common-errors2021-06-22T12:23:12+02:00Jan PavlinecAdd section about updater download error to common-errorsThis could help lower the number of complaints from users (forum and/or support). We could also refer them to this page.
Related issues:
- https://gitlab.nic.cz/turris/updater/supervisor/-/issues/24
- https://gitlab.nic.cz/turris/update...This could help lower the number of complaints from users (forum and/or support). We could also refer them to this page.
Related issues:
- https://gitlab.nic.cz/turris/updater/supervisor/-/issues/24
- https://gitlab.nic.cz/turris/updater/supervisor/-/issues/15https://gitlab.nic.cz/turris/user-docs/-/issues/145Document DVB tuner(s)2021-05-31T13:36:53+02:00Josef SchlehoferDocument DVB tuner(s)Because DVB tuners are for now feature which we was prepared by our ex-colleagues, we should document it in our documentation and describe what needs to be done when the DVB tuner is not supported and so on.
Exactly like it was done in ...Because DVB tuners are for now feature which we was prepared by our ex-colleagues, we should document it in our documentation and describe what needs to be done when the DVB tuner is not supported and so on.
Exactly like it was done in wiki:
https://docs.turris.cz/basics/apps/atlas/https://gitlab.nic.cz/turris/user-docs/-/issues/142Article about hardening Turris router2021-07-28T14:45:54+02:00Karel KociArticle about hardening Turris routerAlthough Turris routers are as secure as possible out of the box there might still be some considerations and options users could choose to investigate. This should point possibly to topics such as:
* Sentinel
* Jail and Seccomp if we t...Although Turris routers are as secure as possible out of the box there might still be some considerations and options users could choose to investigate. This should point possibly to topics such as:
* Sentinel
* Jail and Seccomp if we trust them enoughhttps://gitlab.nic.cz/turris/user-docs/-/issues/141How to remove or uninstalled packages2024-03-27T16:40:54+01:00Josef SchlehoferHow to remove or uninstalled packagesOn our support, we received a response, then he installed some packages from our documentation, but he does not know how he should uninstall it.
I think it is not clear that unchecking and saving it in Package management tab will remove...On our support, we received a response, then he installed some packages from our documentation, but he does not know how he should uninstall it.
I think it is not clear that unchecking and saving it in Package management tab will remove it. :thinking:
What do you think @ljelinek ?Lukas JelinekLukas Jelinekhttps://gitlab.nic.cz/turris/user-docs/-/issues/134Document SSH connection2021-04-21T11:54:14+02:00Martin PrudekDocument SSH connectionSince we advertise our routers as open and we grant the user full root access to the device we should have a proper documentation page about SSH access. Similar page already exists on our [old wiki](https://wiki.turris.cz/doc/cs/howto/ss...Since we advertise our routers as open and we grant the user full root access to the device we should have a proper documentation page about SSH access. Similar page already exists on our [old wiki](https://wiki.turris.cz/doc/cs/howto/ssh?s[]=putty).https://gitlab.nic.cz/turris/user-docs/-/issues/130Documentation performance problems in Firefox2021-03-17T20:23:31+01:00Lukas JelinekDocumentation performance problems in FirefoxSome documentation pages, especially those with multiple images, are very slow when scrolling. This process is very CPU-consuming and allocates huge amounts of memory (hundreds of MBs per second up to several GBs; it could lead to killin...Some documentation pages, especially those with multiple images, are very slow when scrolling. This process is very CPU-consuming and allocates huge amounts of memory (hundreds of MBs per second up to several GBs; it could lead to killing the browser by oom_killer).
These problems occur only in Firefox (version 86.0 in Linux). They probably don't affect browsers based on Webkit/Blink (tested in Chromium, Opera and Rekonq).https://gitlab.nic.cz/turris/user-docs/-/issues/125Suggest a way/ways how to set up a router if a server with public domain is b...2021-12-21T16:50:26+01:00Stepan RechnerSuggest a way/ways how to set up a router if a server with public domain is behind itBy default, it is possible to connect to a domain located in the same LAN only by adding `*.lan`. It may be an easy way to set it smoother for a user (usable for example for some CTI users). To add this sort of how-to was suggested by @v...By default, it is possible to connect to a domain located in the same LAN only by adding `*.lan`. It may be an easy way to set it smoother for a user (usable for example for some CTI users). To add this sort of how-to was suggested by @vcunat and later on by a user even to set it up by default:
>>>
after searching for hours - I was not able to setup the firewall rules accordingly.
The most simple solution is
####
Adding static address records
Extend section config resolver 'kresd' of /etc/config/resolver by
list hostname_config '/etc/hosts'
#####
Why is this not enabled by default?
...
>>>
It looks like there can be basically two ways.
1. IP based: traffic routed to an external IP (NAT WAN) re-route to the LAN IP address of the server. (According to @vcunat probably the cleaner way)
2. DNS based: for the LAN devices to return the LAN IP address.https://gitlab.nic.cz/turris/user-docs/-/issues/121Explain status of LED colors using rescue modes2021-03-06T05:34:58+01:00Josef SchlehoferExplain status of LED colors using rescue modesOne guy on Reddit reported to us what means if all LEDs are green and it would be good to mention what means if all LEDs are blue or red. And what users should do if it ends up in error.
Reference: https://www.reddit.com/r/Turris/commen...One guy on Reddit reported to us what means if all LEDs are green and it would be good to mention what means if all LEDs are blue or red. And what users should do if it ends up in error.
Reference: https://www.reddit.com/r/Turris/comments/l5meas/all_leds_green_during_restore/Michal HruseckyMichal Hruseckyhttps://gitlab.nic.cz/turris/user-docs/-/issues/118Add a bridge/access point/switch mode setting how-to2021-01-22T15:51:55+01:00Stepan RechnerAdd a bridge/access point/switch mode setting how-toIt is possible to set a Turris router up via (re)Foris to a mode when it does not provide services like DHCP or DNS. It may be wanted for example for a use-case when there is a need to extend a Wi-Fi signal to a further place of a house....It is possible to set a Turris router up via (re)Foris to a mode when it does not provide services like DHCP or DNS. It may be wanted for example for a use-case when there is a need to extend a Wi-Fi signal to a further place of a house. It is even more convenient when there the same SSID and password is set up because this way the switch between the two APs is smooth.
We send to those, who are interested in this setting similar instruction as follows:
>>>
If you wish to set your Turris router to a bridge/access point/switch mode, it is possible to do that in the (re)Foris interface in two steps:
1st step: Go to the tab "NETWORK INTERFACES" (or in reForis "Interfaces" tab in the "Network Settings" menu):
- Move all the interfaces from WAN to LAN. If you click on an interface, you will find an option to change the network.
- Then confirm with the "Save" button.
2nd step: Move to the "LAN" tab and choose:
- "LAN mode" as "Computer"
- "IPv4 protocol" as "DHCP (automatic configuration)
- and confirm with the "Save" button.
At this point, the IP addresses change (your router will not listen at its default address anymore, but on the one, that it receives from the main router). You may need to disconnect the Ethernet cable and connect it again. The address <https://turris.local> may keep working.
After that, you may be reconnected to the new IP address automatically. If not, you will need to find out the new address in your main router.
>>>https://gitlab.nic.cz/turris/user-docs/-/issues/107schnapps: improve documentation for remote snapshots2024-03-12T16:02:04+01:00Karel Kocischnapps: improve documentation for remote snapshotsRight now configuration there is kind of pilled up in one section. It does not make any difference between protocols and that can be confusing to users (such as turris/schnapps#29).
I think that reorganizing it to have dedicated section...Right now configuration there is kind of pilled up in one section. It does not make any difference between protocols and that can be confusing to users (such as turris/schnapps#29).
I think that reorganizing it to have dedicated sections for configuration required for specific supported protocol should be made. That is there should be dedicated section for every protocol schnapps support with suggested (example) configuration. It might also make sense to split whole article to multiple articles to make navigation in it easier (adding another subsections might make it rather complicated and long).Michal HruseckyMichal Hruseckyhttps://gitlab.nic.cz/turris/user-docs/-/issues/104Correct router uplink connection documentation2020-12-17T13:14:47+01:00Karel KociCorrect router uplink connection documentationWell I thought it is pretty much clear how router should be connected but from feedback on support it is not clear at all.
This should cover cases such as:
* connect it as directly as possible (replace existing router and/or connect di...Well I thought it is pretty much clear how router should be connected but from feedback on support it is not clear at all.
This should cover cases such as:
* connect it as directly as possible (replace existing router and/or connect directly behind modem)
* switch modem to bridge mode if possiblehttps://gitlab.nic.cz/turris/user-docs/-/issues/103Add a how-to about Turris MOX (dis)assembly2020-12-08T15:08:03+01:00Stepan RechnerAdd a how-to about Turris MOX (dis)assemblySuggested notes to mention:
* link to an [instruction video](https://youtu.be/yL8Rpo0Wshc)
* to be careful while pulling off the sides if a Wi-Fi card is included (antennas are glued to them)
* how to arrange the pigtails (especially the...Suggested notes to mention:
* link to an [instruction video](https://youtu.be/yL8Rpo0Wshc)
* to be careful while pulling off the sides if a Wi-Fi card is included (antennas are glued to them)
* how to arrange the pigtails (especially the SDIO card; @jhoracek knows)
* the order or different modules matters + link to our [configurator](https://mox-configurator.turris.cz/)
Related ticket in the RT system: `#1187655: Opening the router?`https://gitlab.nic.cz/turris/user-docs/-/issues/98Review factory image for Shield2020-11-14T01:07:11+01:00Vojtech MyslivecReview factory image for ShieldShield is distributed with %"Turris OS 5.1.2", yet we announce it was %"Turris OS 5.1.0"
From currently published [docs](https://docs.turris.cz/basics/tos_versions/):
![Screenshot_from_2020-11-14_01-04-42](/uploads/ad92c58c267310e8a99...Shield is distributed with %"Turris OS 5.1.2", yet we announce it was %"Turris OS 5.1.0"
From currently published [docs](https://docs.turris.cz/basics/tos_versions/):
![Screenshot_from_2020-11-14_01-04-42](/uploads/ad92c58c267310e8a99286446a60429a/Screenshot_from_2020-11-14_01-04-42.png)
From fresh new unpacked Shield:
![Screenshot_from_2020-11-14_01-06-12](/uploads/109e977befbf54ca60a85379aad88653/Screenshot_from_2020-11-14_01-06-12.png)
It would be nice to include this info in the docsMichal HruseckyMichal Hruseckyhttps://gitlab.nic.cz/turris/user-docs/-/issues/97Add software erratum2021-06-22T12:24:51+02:00Karel KociAdd software erratumWe should create article with long-standing software issues we know about we can't do anything about.
Feel free to add any known ones in here for now.
* DDNS scripts might delay update until we kill process
turris-os-packages#265We should create article with long-standing software issues we know about we can't do anything about.
Feel free to add any known ones in here for now.
* DDNS scripts might delay update until we kill process
turris-os-packages#265https://gitlab.nic.cz/turris/user-docs/-/issues/96Erratum for Turris Shield2021-04-12T10:19:51+02:00Karel KociErratum for Turris ShieldThis should mention at minimum:
* LAN4 port issue
* IP assignment issue (that LAN IP address is removed if connected to 192.168.1.1/24 network on WAN side)This should mention at minimum:
* LAN4 port issue
* IP assignment issue (that LAN IP address is removed if connected to 192.168.1.1/24 network on WAN side)Michal HruseckyMichal Hrusecky