Skip to content
GitLab
Menu
Projects
Groups
Snippets
/
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Menu
Open sidebar
Turris
user-docs
Commits
b4d8fe04
Verified
Commit
b4d8fe04
authored
Jul 28, 2021
by
Lukas Jelinek
🗄
Browse files
basics/foris: Modify pages to include shared content from reForis
parent
5ad1824b
Changes
4
Hide whitespace changes
Inline
Side-by-side
docs/basics/foris/https/firefox-01.png
deleted
100644 → 0
View file @
5ad1824b
59.7 KB
docs/basics/foris/https/firefox-02.png
deleted
100644 → 0
View file @
5ad1824b
78.5 KB
docs/basics/foris/https/https.md
View file @
b4d8fe04
...
...
@@ -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:

2.
Press the _Advanced..._ button to display more details:

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-->
"
%}
docs/basics/foris/storage-plugin/storage-plugin.md
View file @
b4d8fe04
...
...
@@ -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.
...
...
Write
Preview
Supports
Markdown
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment