You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Take a look at the `README on GitHub <https://github.com/Eeems-Org/remarkable.guide/#can-i-make-changes>`_. Issues and Pull Requests are welcome.
19
+
12
20
Is it safe to factory reset my device?
13
-
======================================
21
+
--------------------------------------
14
22
15
23
Not exactly. The factory reset mechanism isn't a true factory reset. It will wipe your data partition, but it doesn't do anything to the root partition where the OS is installed. This can soft brick your device if you have toltec installed, or other third party software. The :doc:`tech/factory-reset` page contains instructions on how to properly factory reset your device.
16
24
17
25
There have been instances where factory resetting without third party software installed results in the SSH password no longer displaying on the "Copyright and licenses" screen. This appears to be due to the root partition running out of space. See `My device is connected to wifi, but can't sync or check for updates, how can I fix this?`_ for more information on resolving this.
18
26
27
+
.. _upgrade:
28
+
29
+
Can I downgrade to a different OS version?
30
+
------------------------------------------
31
+
32
+
Yes! You can use `codexctl <https://github.com/Jayy001/codexctl>`_ to download and install different OS versions on your device.
33
+
34
+
The file format used to store lines you draw in notebooks/pdfs/epubs sometimes changes between versions. This means that if you downgrade, you may not be able to open one, or all, of your notebooks until you upgrade again.
35
+
36
+
How get back to stable after installing the beta?
37
+
-------------------------------------------------
38
+
39
+
First leave the beta program. After that, follow the instructions in `Can I downgrade to a different OS version?`_ to downgrade to an older version. After you downgrade, you will be able to go through the normal upgrade process to get to the latest available stable version.
40
+
41
+
I updated my OS, but now I can't SSH into my device. How do I fix it?
Every time you update your OS, the cryptographic key used to identify the device over SSH is regenerated. This means that the software you are using to SSH into your device will no longer trust it and refuse to connect. To resolve this you need to remove the entry for the reMarkable in your ``known_hosts`` file on your computer. This is usually located in the ``.ssh`` folder in your home directory. The software you use to SSH may have these values stored elsewhere.
45
+
46
+
Why would I use SSH over USB instead of wifi?
47
+
---------------------------------------------
48
+
49
+
SSH over USB on the device is much faster than SSH over wifi.
The reMarkable Paper Pro and Paper Pro Move have the root filesystem marked as read only, and certain folders have `overlays <https://en.wikipedia.org/wiki/OverlayFS>`_ where any changes will not persist between reboots.
57
+
58
+
To make the root filesystem read-write:
59
+
60
+
.. code-block:: shell
61
+
62
+
mount -o remount,rw /
63
+
64
+
If you need to make a change to a folder that is mounted as an overlay, you can just unmount the overlay (and remount the ssh host keys so you will be able to reconnect). For example:
65
+
66
+
.. code-block:: shell
67
+
68
+
umount -R /etc
69
+
mount -t bind /home/root/.dropbear /etc/dropbear
70
+
71
+
To see a full list of folders that have overlays you can run the following command:
72
+
73
+
.. code-block:: shell
74
+
75
+
mount | grep overlay
76
+
77
+
After making your changes and rebooting you should see your changes persist. But the overlay will be back and the filesystem will be read-only again.
78
+
79
+
If you don't want to reboot, you can set the filesystems back to their normal state by running the following commands, IN THIS ORDER:
80
+
81
+
.. code-block:: shell
82
+
83
+
mount -o remount,ro /
84
+
umount /etc/dropbear
85
+
mount -o rw,relatime,lowerdir-/etc,upperdir-/var/volatile/etc,workdir-/var/volatile/.etc-work -t overlay overlay /etc
86
+
mount -t bind /home/root/.dropbear /etc/dropbear
87
+
88
+
Note that you can get the value of the ``-o`` option in the second ``mount`` command by running the ``mount | grep overlay`` command noted above, *before* unmounting anything.
89
+
90
+
Third Party Software FAQs
91
+
=========================
92
+
19
93
How do I remove all third party software from my device?
This all depends on how you installed them. If you installed toltec, it has a simple uninstall command: `toltecctl uninstall`. This will remove toltec and all of its changes.
23
97
@@ -28,7 +102,7 @@ For other third party software, they may provide an uninstall script, or they ma
As of September 2025, third party development for these devices is still ongoing. At present, you can `SSH into the device <https://remarkable.guide/guide/access/ssh.html>`_ by `enabling developer mode <https://remarkable.guide/tech/developer-mode.html>`_, and you can `perform a recovery on your device if necessary <https://remarkable.guide/tech/recovery.html>`.
34
108
@@ -38,27 +112,14 @@ You can see more technical information regarding the Paper Pro in `this Github i
38
112
39
113
You can see more technical information regarding the Paper Pro Move in `this Github issue for Paper Pro Move <https://github.com/Eeems-Org/remarkable.guide/issues/99>`_.
40
114
41
-
.. _upgrade:
42
-
43
-
Can I downgrade to a different OS version?
44
-
==========================================
45
-
46
-
Yes! You can use `codexctl <https://github.com/Jayy001/codexctl>`_ to download and install different OS versions on your device.
47
-
48
-
The file format used to store lines you draw in notebooks/pdfs/epubs sometimes changes between versions. This means that if you downgrade, you may not be able to open one, or all, of your notebooks until you upgrade again.
49
-
50
-
How get back to stable after installing the beta?
51
-
=================================================
52
-
53
-
First leave the beta program. After that, follow the instructions in `Can I downgrade to a different OS version?`_ to downgrade to an older version. After you downgrade, you will be able to go through the normal upgrade process to get to the latest available stable version.
54
115
55
116
Can I install toltec on my OS version?
56
-
======================================
117
+
--------------------------------------
57
118
58
119
You can find up to date information on what version of the OS is the latest that toltec supports on the `toltec website <https://toltec-dev.org/#install-toltec>`_
59
120
60
121
Can I install toltec before my OS version is supported?
On a reMarkable 2, you **will** soft-brick your device if you install toltec on an unsupported version. Due to how the display is accessed by third party software on a reMarkable 2, your device will **no longer** be able to display anything to the screen until you uninstall toltec. If you know what you are doing, you can provide a custom rm2fb configuration file to resolve this. This requires knowing how to find the values needed. It also may not work if there is a large enough change in this OS release that breaks rm2fb support without code changes.
64
125
@@ -67,34 +128,27 @@ On a reMarkable 1, you **might** soft-brick your device if there are any breakin
67
128
For both devices, there may be issues with packages (like custom kernels) that could soft brick your device. Packages may have other issues and not work as expected before the OS version is supported.
68
129
69
130
Why doesn't toltec support the beta OS versions?
70
-
================================================
131
+
------------------------------------------------
71
132
72
133
As part of the `EULA <https://support.remarkable.com/s/article/End-user-agreement-for-Opt-In-Beta>`_ you agree to in order to be able to install the beta, you agree that you will not install third party software on the device.
73
134
74
135
Can I install toltec at the same time as ddvk-hacks?
Yes! Toltec even ships with a ddvk-hacks package to handle installation for you. While you can install toltec while using the ddvk-hacks automagic install script, it may not play nice with toltec in the future. It is recommended to use the toltec package instead of the automagic script.
78
139
79
-
I updated my OS, but now I can't SSH into my device. How do I fix it?
Every time you update your OS, the cryptographic key used to identify the device over SSH is regenerated. This means that the software you are using to SSH into your device will no longer trust it and refuse to connect. To resolve this you need to remove the entry for the reMarkable in your ``known_hosts`` file on your computer. This is usually located in the ``.ssh`` folder in your home directory. The software you use to SSH may have these values stored elsewhere.
83
-
84
140
What happens to third party software when I update or downgrade my OS?
When you update or downgrade your OS, the entire root partition is replaced with the new OS. Only the data partition, which is all files under ``/home`` is left untouched. This means that any third party software that relies on modifying files outside of ``/home`` will need to be reapplied.
88
144
89
145
For software with toltec you just need to follow the instructions in :ref:`toltec-reenable`. For third party software installed with other methods, you will need to check their instructions.
90
146
91
-
I noticed something incorrect on this site, how do I get that fixed?
You could attempt the following troubleshooting steps:
100
154
@@ -113,13 +167,13 @@ You could attempt the following troubleshooting steps:
113
167
114
168
.. code-block:: shell
115
169
116
-
journalctl --vacuum-size=1
170
+
journalctl --vacuum-size-1
117
171
118
172
- If running ``df -h /`` still reports ``Use%`` as ``100%``, you may need to remove other files from your device. If you have installed :doc:`custom templates <guide/software/templates>`, :doc:`splash screens <guide/software/screens>`, or fonts, you may need to remove them.
119
173
- If you still are unable to free up space, ask for help on the `community discord <https://discord.gg/ATqQGfu>`_.
120
174
121
175
My device is stuck on the power off screen and wont turn on, what do I do?
When your reMarkable is showing the powered off screen, but won't turn on, your battery is probably completely depleted. Because of how the e-Ink technology works, the screen will continue to show the power off message. It will take a while of charging until there's enough battery to restart the device.
125
179
@@ -128,7 +182,7 @@ Let the device charge for a few hours and then try to turn it on again. If it st
128
182
.. _enable-ssh-rsa:
129
183
130
184
How do I resolve the "no matching host key type found. Their offer: ssh-rsa" error when attempting to SSH into my device?
Starting with OpenSSH 8.8 ssh-rsa keys are `disabled by default <https://www.openssh.com/txt/release-8.7>`_, which is causing this error. Some Linux distros like Fedora 33 have also disabled weaker ssh-rsa keys independently of OpenSSH. That means you could face the same issue on OpenSSH versions lower than 8.8, depending on the distro you are on.
134
188
@@ -138,47 +192,3 @@ To allow ssh-rsa keys, add the following lines to your :ref:`ssh_config`:
138
192
139
193
PubkeyAcceptedKeyTypes +ssh-rsa
140
194
HostKeyAlgorithms +ssh-rsa
141
-
142
-
Why would I use SSH over USB instead of wifi?
143
-
=============================================
144
-
145
-
SSH over USB on the device is much faster than SSH over wifi.
The reMarkable Paper Pro and Paper Pro Move have the root filesystem marked as read only, and certain folders have `overlays <https://en.wikipedia.org/wiki/OverlayFS>`_ where any changes will not persist between reboots.
153
-
154
-
To make the root filesystem read-write:
155
-
156
-
.. code-block:: shell
157
-
158
-
mount -o remount,rw /
159
-
160
-
If you need to make a change to a folder that is mounted as an overlay, you can just unmount the overlay (and remount the ssh host keys so you will be able to reconnect). For example:
161
-
162
-
.. code-block:: shell
163
-
164
-
umount -R /etc
165
-
mount -t bind /home/root/.dropbear /etc/dropbear
166
-
167
-
To see a full list of folders that have overlays you can run the following command:
168
-
169
-
.. code-block:: shell
170
-
171
-
mount | grep overlay
172
-
173
-
After making your changes and rebooting you should see your changes persist. But the overlay will be back and the filesystem will be read-only again.
174
-
175
-
If you don't want to reboot, you can set the filesystems back to their normal state by running the following commands, IN THIS ORDER:
176
-
177
-
.. code-block:: shell
178
-
179
-
mount -o remount,ro /
180
-
umount /etc/dropbear
181
-
mount -o rw,relatime,lowerdir=/etc,upperdir=/var/volatile/etc,workdir=/var/volatile/.etc-work -t overlay overlay /etc
182
-
mount -t bind /home/root/.dropbear /etc/dropbear
183
-
184
-
Note that you can get the value of the ``-o`` option in the second ``mount`` command by running the ``mount | grep overlay`` command noted above, *before* unmounting anything.
0 commit comments