|
| 1 | +=================================== |
| 2 | +Connecting to an rmfakecloud Server |
| 3 | +=================================== |
| 4 | + |
| 5 | +Using `rmfakecloud <https://github.com/ddvk/rmfakecloud>`_, you can synchronize your notes and documents between Xochitl (the default reMarkable app) and alternative cloud servers. |
| 6 | +Among other benefits, this **puts you back in control** of your data, allows you to **setup automated backups** on the server side, and gives you a web-based interface to browse your notes. |
| 7 | + |
| 8 | +.. figure:: /_static/images/rmfakecloud-web-interface.png |
| 9 | + :width: 100% |
| 10 | + :class: screenshot |
| 11 | + |
| 12 | + rmfakecloud’s web interface |
| 13 | + |
| 14 | +This page will guide you through the steps needed to connect your device to an rmfakecloud server using Toltec. |
| 15 | + |
| 16 | +*Note: You can only be connected to one server at a time.* |
| 17 | +*You will not be able to connect to the reMarkable cloud service and an rmfakecloud server simultaneously.* |
| 18 | +*It is easy to* `switch between servers <#switching-to-a-different-server>`_, *though.* |
| 19 | + |
| 20 | +Before Getting Started |
| 21 | +---------------------- |
| 22 | + |
| 23 | +First, make sure you **have access to an account on any rmfakecloud instance**. |
| 24 | +You can set up your own instance by following the `instructions from the repository <https://github.com/ddvk/rmfakecloud>`_. |
| 25 | +Take note of the server address; in the following, we’ll use ``https://rmfakecloud.example.com`` as an example server address. |
| 26 | + |
| 27 | +It’s also a good idea to **make a full backup of your data** before following the steps below. |
| 28 | +Make sure you’ve synced your documents with the reMarkable cloud service, as you will get disconnected during the process. |
| 29 | +The simplest way to make a backup is to `copy the contents <https://remarkablewiki.com/tech/file_transfer>`_ of ``/home/root/.local/share/remarkable`` (on your device) to a safe location. |
| 30 | + |
| 31 | +Installing the Proxy |
| 32 | +-------------------- |
| 33 | + |
| 34 | +Xochitl does not have built-in support for alternative servers, so we need to trick the app into *believing* it’s connecting to the main reMarkable servers even though it’s actually connecting to your server of choice. |
| 35 | +Fortunately, Toltec provides a package that automates all these steps for you. |
| 36 | +Start an `SSH session <https://remarkablewiki.com/tech/ssh>`_ to your device and type the following command at the prompt:: |
| 37 | + |
| 38 | + opkg install rmfakecloud-proxy |
| 39 | + |
| 40 | +Once the package is installed, select a server to connect to:: |
| 41 | + |
| 42 | + rmfakecloudctl set-upstream https://rmfakecloud.example.com |
| 43 | + |
| 44 | +Finally, run the command below to switch to that server. |
| 45 | +This will disconnect you from the cloud (if you were connected), create a local self-signed certificate authority, and start a proxy that forwards any request directed to the official servers towards your selected server:: |
| 46 | + |
| 47 | + rmfakecloudctl enable |
| 48 | + |
| 49 | +If all goes well, you should get a message saying *“rmfakecloud-proxy is now enabled”* in your terminal. |
| 50 | + |
| 51 | +Logging in to Your Account |
| 52 | +-------------------------- |
| 53 | + |
| 54 | +Congratulations, your device is now talking to your rmfakecloud server of choice! |
| 55 | +The last remaining step is to login to your account exactly as if you were connecting to your reMarkable account. |
| 56 | + |
| 57 | +On your computer, browse to your rmfakecloud server’s web interface, login, then go to the *Code* tab to retrieve an eight-letter one-time-code. |
| 58 | +On your device, go to *Menu > Settings > Account > Connect to reMarkable cloud > Connect*, then input that code. |
| 59 | + |
| 60 | +Once this is done, you’re all set! Note that the initial sync may take some time as it will upload all your documents to the new server. |
| 61 | + |
| 62 | +Switching to a Different Server |
| 63 | +------------------------------- |
| 64 | + |
| 65 | +Once the rmfakecloud proxy is setup on your device, you can switch to any other rmfakecloud instance by doing:: |
| 66 | + |
| 67 | + rmfakecloud set-upstream https://other-rmfakecloud.example.com |
| 68 | + |
| 69 | +Each server switch will disconnect you from the cloud, so you’ll need to log back in to your respective accounts. |
| 70 | + |
| 71 | +Reverting Back to the reMarkable Servers |
| 72 | +---------------------------------------- |
| 73 | + |
| 74 | +It’s easy to revert back to syncing with the reMarkable cloud service, just run the following command:: |
| 75 | + |
| 76 | + rmfakecloud disable |
| 77 | + |
| 78 | +After the uninstallation process completes, head to *Menu > Settings > Account > Connect to reMarkable cloud > Connect* again and input a login code from the official servers to log back in to your account. |
0 commit comments