user-docs issueshttps://gitlab.nic.cz/turris/user-docs/-/issues2021-10-19T14:58:20+02:00https://gitlab.nic.cz/turris/user-docs/-/issues/139Improve instructions how to build/deploy documentation2021-10-19T14:58:20+02:00Lukas JelinekImprove instructions how to build/deploy documentationInstructions how to build and deploy the documentation are incomplete (e.g don't contain authentication to the GitLab server) and need to be improved.Instructions how to build and deploy the documentation are incomplete (e.g don't contain authentication to the GitLab server) and need to be improved.Lukas JelinekLukas Jelinekhttps://gitlab.nic.cz/turris/user-docs/-/issues/138tyy → tty2021-05-18T12:37:59+02:00Dirk Hoffmanntyy → ttyIt's a minor issue, but you have two occurences of `tyy` (instead of `tty`) in [hw/serial.md](docs/hw/serial.md#L79-92)It's a minor issue, but you have two occurences of `tyy` (instead of `tty`) in [hw/serial.md](docs/hw/serial.md#L79-92)https://gitlab.nic.cz/turris/user-docs/-/issues/137Add documentation for running diagnostics from terminal2021-10-15T13:21:53+02:00Karel KociAdd documentation for running diagnostics from terminalThe current documentation specifies how to collect logs manually but we can also generate diagnostics from terminal. With turris/os/packages!743 this should be even easier:
```sh
turris-diagnostics | gzip > diag.gz
```
The documentation...The current documentation specifies how to collect logs manually but we can also generate diagnostics from terminal. With turris/os/packages!743 this should be even easier:
```sh
turris-diagnostics | gzip > diag.gz
```
The documentation should probably state:
* How to generate diagnostics
* How to get them from router over SSH
* That user should remove them afterwards so they are not taking up space or that he should generate them in /tmphttps://gitlab.nic.cz/turris/user-docs/-/issues/136Micro SD card check2021-05-10T16:34:52+02:00Lukas JelinekMicro SD card checkThe documentation should mention that the Micro SD card can be checked whether it is inserted and locked properly if MOX or Shield can't boot (and that if the card isn't inserted properly the device can't boot).
Based on experience of o...The documentation should mention that the Micro SD card can be checked whether it is inserted and locked properly if MOX or Shield can't boot (and that if the card isn't inserted properly the device can't boot).
Based on experience of our support (reported by @mblazkova).https://gitlab.nic.cz/turris/user-docs/-/issues/135Document that ISP or some research organization migh contant users running Se...2021-04-27T14:09:24+02:00Karel KociDocument that ISP or some research organization migh contant users running SentinelIt is possible that ISP or some research organization can contact users and tell them or even request from them blockage of "unsecure" service they are running. In most cases that is going to be Sentinel Minipot but user should check any...It is possible that ISP or some research organization can contact users and tell them or even request from them blockage of "unsecure" service they are running. In most cases that is going to be Sentinel Minipot but user should check anyway and respond to such request with info that he is running honeypot as part of CZ.NIC security research. We should document such response and and tell explicitly users that this can happen and that all sides are rather doing their work pretty well at that point.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/133Shield overall description2021-06-16T17:35:22+02:00Vojtech MyslivecShield overall descriptionAdd or extend overall Shield description to make clear what it exactly is.
Shield
- Is not a MOX
- Is not modular/extensible
- Has automatic updates enabled and not configurable
- Has Turris Sentinel, OpenVPN and NetMetr preinstalled
- ...Add or extend overall Shield description to make clear what it exactly is.
Shield
- Is not a MOX
- Is not modular/extensible
- Has automatic updates enabled and not configurable
- Has Turris Sentinel, OpenVPN and NetMetr preinstalled
- Does not have full-value Turris OS
- Does not have LuCI
- Does not include options to install extra software
- ReForis interface is pruned and crippled (e.g. no Guest network)
- The only supported setup is a router with WAN Ethernet uplink (PPPoE possible) and 4x LAN Ethernet downlink, with IPv4 NAT and IPv6 prefix delegation (from DHCPv6)
Also, we must mark visibly some software features that are not present or supported on Shield.Lukas JelinekLukas Jelinekhttps://gitlab.nic.cz/turris/user-docs/-/issues/132Fix links to firmware and uboot2021-06-04T09:59:58+02:00Lukas JelinekFix links to firmware and ubootThe remote link checker currently reports two broken links:
- [secure-firmware](https://gitlab.nic.cz/turris/turris-os-packages/-/raw/master/hardware/mox/mox-support/files/secure-firmware.bin)
- [uboot](https://gitlab.nic.cz/turris/turri...The remote link checker currently reports two broken links:
- [secure-firmware](https://gitlab.nic.cz/turris/turris-os-packages/-/raw/master/hardware/mox/mox-support/files/secure-firmware.bin)
- [uboot](https://gitlab.nic.cz/turris/turris-os-packages/-/raw/master/hardware/mox/mox-support/files/uboot)
These links are apparently no longer valid and should be replaced by the working ones.https://gitlab.nic.cz/turris/user-docs/-/issues/131Proper cables2021-05-18T15:58:21+02:00Vojtech MyslivecProper cablesBased on [tracker#1258200](https://tracker.nic.cz/Ticket/Display.html?id=1258200), we should state somewhere near "first setup" this warning/information:
> Make sure you use proper Gigabit Ethernet cables i.e. Cat 5e or Cat 6 straight u...Based on [tracker#1258200](https://tracker.nic.cz/Ticket/Display.html?id=1258200), we should state somewhere near "first setup" this warning/information:
> Make sure you use proper Gigabit Ethernet cables i.e. Cat 5e or Cat 6 straight unshielded twisted pair cables with 8 wires (8P8C) to connect your devices to the Turris as well as your Turris to the modem or other ISP device.
exact wording could be improvedLukas JelinekLukas Jelinekhttps://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/129Shield factory reset / rescue modes2021-05-03T16:15:52+02:00Lukas JelinekShield factory reset / rescue modesThere are factory reset guides (for rescue modes respectively) for various device but not for Shield. It is performed similarly to [MOX](https://docs.turris.cz/hw/mox/rescue-modes/) but there are some differences which should be document...There are factory reset guides (for rescue modes respectively) for various device but not for Shield. It is performed similarly to [MOX](https://docs.turris.cz/hw/mox/rescue-modes/) but there are some differences which should be documented. Some parts of the documentation can be shared between MOX and Shield.
Originally suggested in #72 but not yet written.https://gitlab.nic.cz/turris/user-docs/-/issues/128Solidify instructions of router connection for initial configuration2021-10-19T14:58:36+02:00Karel KociSolidify instructions of router connection for initial configurationThere is possibility that user might not understand the initial documentation and he would try to connect the router not only to computer he is trying to configure but also to existing network. In such case the instructions are invalid a...There is possibility that user might not understand the initial documentation and he would try to connect the router not only to computer he is trying to configure but also to existing network. In such case the instructions are invalid as router does not control DHCP.Lukas JelinekLukas Jelinekhttps://gitlab.nic.cz/turris/user-docs/-/issues/127oEmbed / OpenGraph tags could not be found2021-03-03T15:50:14+01:00Josef SchlehoferoEmbed / OpenGraph tags could not be foundHi,
I wanted to reply on the forum and linked one article in it, but it should display a preview of that page, but it does not.
![image](/uploads/e475cdf1b98b088644b0ab9a75fcf7f5/image.png)
Is there a possibility to fix it?Hi,
I wanted to reply on the forum and linked one article in it, but it should display a preview of that page, but it does not.
![image](/uploads/e475cdf1b98b088644b0ab9a75fcf7f5/image.png)
Is there a possibility to fix it?Aleksandr GumroianAleksandr Gumroianhttps://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/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/124Add documentation about notifications2021-05-18T15:58:23+02:00Lukas JelinekAdd documentation about notificationsAdd documentation page about notifications and their configuration in reForis.Add documentation page about notifications and their configuration in reForis.Lukas JelinekLukas Jelinekhttps://gitlab.nic.cz/turris/user-docs/-/issues/123Wi-Fi configuration in reForis2021-05-18T15:58:31+02:00Lukas JelinekWi-Fi configuration in reForisWe don't have any documentation page about Wi-Fi configuration (even for Foris). This feature is often used and therefore should be documented.We don't have any documentation page about Wi-Fi configuration (even for Foris). This feature is often used and therefore should be documented.Lukas JelinekLukas Jelinekhttps://gitlab.nic.cz/turris/user-docs/-/issues/122Applications - OpenVPN, Pakon, Sentinel shows 404 not found2021-05-18T15:58:28+02:00Josef SchlehoferApplications - OpenVPN, Pakon, Sentinel shows 404 not foundRelated to turris/user-docs#120, when you are using this URL: https://docs.turris.cz/basics/apps/netmetr
Affected URLs (can be found in menu Software - Applications):
- https://docs.turris.cz/basics/pakon/
- https://docs.turris.cz/basic...Related to turris/user-docs#120, when you are using this URL: https://docs.turris.cz/basics/apps/netmetr
Affected URLs (can be found in menu Software - Applications):
- https://docs.turris.cz/basics/pakon/
- https://docs.turris.cz/basics/openvpn-client/openvpn/
- https://docs.turris.cz/basics/openvpn-server/openvpn/
- https://docs.turris.cz/basics/sentinel/Lukas JelinekLukas Jelinekhttps://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/120Missing / ("slash") leads to missing pictures in article2021-05-18T15:58:26+02:00Josef SchlehoferMissing / ("slash") leads to missing pictures in articleToday, I met this issue once again so I decided to report this.
1. If you go to this site: https://docs.turris.cz/geek/nextcloud/nextcloud
**Pictures are missing.**
But if you add a slash in the URL, so it looks like this: https://do...Today, I met this issue once again so I decided to report this.
1. If you go to this site: https://docs.turris.cz/geek/nextcloud/nextcloud
**Pictures are missing.**
But if you add a slash in the URL, so it looks like this: https://docs.turris.cz/geek/nextcloud/nextcloud/ **pictures are there.**
Can we make a redirect or something like that?Lukas JelinekLukas Jelinek