Verified Commit b4d8fe04 authored by Lukas Jelinek's avatar Lukas Jelinek 🗄
Browse files

basics/foris: Modify pages to include shared content from reForis

parent 5ad1824b
......@@ -19,46 +19,11 @@ way is to use HTTPS**. Why is HTTPS safe? For one, HTTPS requires a **trusted
certificate** and if the certificate is not trusted, then warnings are
displayed. We use **self-signed certificates**, which are generated on
factory-reset and cannot, unfortunately, be trusted before the first visit to
Foris and it is recommended to **add a permanent exception in your browser**
the page and it is recommended to **add a permanent exception in your browser**
for the certificate to be trusted in future connections.
## More about warnings
!!! warning
Do not blindly skip untrusted certificate errors. There are there for a
good reason and might be indication of an attack attempt.
Generally, if a warning is displayed on the web page where you happen to be,
**do not proceed!** It is possible that someone simply misconfigured the web
server but there could also be an **ongoing attack**. In case this happens, use
a different device or browser. If that doesn't help, use a different channel to
configure your router or wait for a bit. A few minutes are **not worth your
passwords, card number or any other data!** If you decide to continue to the
web page, you should know exactly what you are doing. Adding the exception for
Foris is one of a little cases where this way is suitable.
## Adding a permanent exception
The certificate is generated on factory reset so you need to add or change the
exception each time you take the router back to factory settings.
!!! tip
We strongly recommend to use Mozilla Firefox for configuration of your
Turris because it has the simplest process to save the exception.
Furthermore it is a free browser (free both as in speech and as in beer),
it is secure, easily extendable by plugins and is available on all common
platforms.
Here is the guide for Mozilla Firefox on any platform (as of the version 67
released in May 2019):
1. When you open the Foris page for the first time this warning is displayed:
![Firefox: Security warning](firefox-01.png)
2. Press the _Advanced..._ button to display more details:
![Firefox: Advanced options](firefox-02.png)
3. Press the _Accept the Risk and Continue_ button now. The exception is
saved and the browser will no longer show the warning text.
{%
include-markdown "../../reforis/https/https.md"
start="<!--access-https-start-->"
end="<!--access-https-end-->"
%}
......@@ -4,31 +4,19 @@ competency: intermediate
---
# Storage plugin
Turris contains an eMMC flash memory card which is used as the system storage. It holds both the Turris OS itself
and the created data. But if you want to use applications which need to save larger amounts of data you can use
an external storage device.
!!! tip
If you want to use [Nextcloud](../../../geek/nextcloud/nextcloud.md),
[LXC](../../../geek/lxc/lxc.md) or other I/O intensive applications, don't put them on the internal flash,
always use external storage! Also please make sure that your data will fit on the new drive before switching.
The storage plugin allows you to easily move your `/srv` to an external drive. It both allows getting more space
and lengthen the lifespan of the internal eMMC flash storage. The `/srv` directory is used for storing
site-specific data as defined in the [FHS specification](https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard).
The storage plugin can't move other parts of the file system. But it doesn't matter because all data-intensive
applications save their data into `/srv`.
{%
include-markdown "../../reforis/storage-plugin/storage-plugin.md"
start="<!--storage-general-start-->"
end="<!--storage-general-end-->"
%}
## First setup
Pick an external storage device, which you want to move your persistent data to. This can be for example a simple USB
flash drive but it is strongly encouraged to use a regular HDD or SSD to get both higher speed and better durability.
!!! warning
Setting up external storage will destroy all data on newly selected storage. Make sure that the storage device has no important data on it.
In case of an USB drive, insert it into the USB slot on your router. If you are using a different type of storage,
make sure that it is properly inserted or connected to the router.
{%
include-markdown "../../reforis/storage-plugin/storage-plugin.md"
start="<!--storage-first-start-->"
end="<!--storage-first-end-->"
%}
Once the external storage is inserted, inside the tab Storage in Foris, select where your persistent
data should be stored and press the _Format & Set_ button.
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment