Installing remux and KOReader on the reMarkable 2 (2nd Edition)


This is a new edition of my original post for installing the above software. I first wrote it back in January, and since then the ecosystem has moved on. Whilst I didn’t intend for it to become a popular guide, it appears it has… and so here are a newer set of instructions.


These instructions worked when I wrote them. There is an active community on discord who can help, if problems are encountered, but no-one makes any guarantees about this software or this guide.


  1. The most important step is to check whether the version of the software you are on is supported by the community. Each release currently necessitates new configuration being discovered and documented.
    1. Go to your Settings Page, and note the software version you are currently on. e.g. 2.11.0442
    2. Open the Toltec website and check what the warning about supported versions says. e.g.
      • Warning: Toltec does not yet support any OS build newer than OS You will soft-brick your device if you install before support is released. See remarkable2-recovery for information on how to recover your device if you have done this.
    3. If your version is the most recent supported version, congratulations you can use Toltec with a minimum of fuss.
    4. If your version is older, you can attempt to update to the most recent supported version
      1. Press the version number shown on your settings page.
      2. Enable auto-updates, if they aren’t already.
      3. Press Check for updates and look at the version it starts to download.
      4. If it’s downloading a newer version than is supported by Toltec then immediately cancel the download by toggling auto-updates off. In this situation stick with your older software version until support is announced.
  2. At this point Disable automatic updates. You will want to re-enable automatic updates only once Toltec gains support for the newer versions. Keep an eye on the toltec website, or their GitHub repository, for new support statements.
  3. Obtain the ReMarkables IP Address and SSH Password
    • Menu > Settings > Help > Copyrights and Licenses > General Information > Look at the bottom
    • WRITE THE SSH PASSWORD DOWN SOMEWHERE SAFE. In case you can’t get back to this screen should something go wrong.
  4. SSH in.
    • ssh root@<ip> and provide the password
  5. (Optional) Setup an SSH Key to allow password-less SSH access.
    • This is useful as there have been reports of the SSH Password changing when the reMarkable software updates, but there has never been a report of the authorised SSH Keys for the root user being reset.
  6. Install Toltec package repository
    • Run the two commands from the website
  7. Install remux – a GUI launcher to switch between apps
    • opkg install remux
  8. Enable remux
    • systemctl enable --now remux
  9. Reboot the reMarkable
    • reboot
  10. Test that remux is working
    • Swipe up from the bottom of the ReMarkable 2. You should see a menu appear with one entry in it.
  11. Install koreader
    • opkg install koreader
  12. Test that koreader is working
    1. Swipe up from the bottom of the ReMarkable 2 and select koreader from the list
    2. In the app, swipe down from the top to access the KOReader menu.
      • Note you can’t read your ReMarkable documents in KOReader as even ePubs appear to be converted in to an incompatible format (inside /home/root/.local/share/remarkable/xochitl for the curious)
  13. Congratulations, you are done!

When a toltec update is available

  1. SSH back in as before
  2. Upgrade the packages
    • opkg update
    • opkg upgrade
  3. Reboot the device

When a reMarkable update is available

  1. Wait until the toltec website declares support for that version
  2. Reenable updates in the reMarkable software, and upgrade
  3. Restart the reMarkable
  4. SSH back in as usual
  5. toltecctl reenable
  6. systemctl enable --now remux
  7. Reboot the device

Nicer toltec package upgrades

  1. You can install the nao package manager to provide a visual way of managing toltec upgrades
    • opkg install nao
  2. You can now use the nao GUI to check for toltec upgrades and to install them. You should still reboot the device after upgrading. It shows up in remix just like KOReader does.

Running bleeding edge software

So you want to run reMarkable software ahead of the current version supported by Toltec? Doing so is outside the scope of this guide, but toltecctl switch-branch is a useful command for such situations. Be warned that the packages in testing may still not support newer reMarkable releases, and may have other problems.

"The World Inside" – Robert Silverberg

As many of you know, I’m an avid reader. Although my intake is predominately fantasy, I do read a healthy dose of crime, YA and other fiction.
In this case, it’s a work of Speculative Fiction – a collection of short stories by Silverberg published as “The World Inside”.
The question the work poses is “What if we encouraged overpopulation. What if we held breeding to be the best activity there is.”. It is with this premise that the world of the Urban Monad is born. The year is 2381. The world population is over 75 billion (up from todays population of 7 billion). To feed that many people vast amounts of food is needed, so vast amounts of land have been given over to farmland, with small communities maintaining the vast amount of agriculture. But where does everyone else go? Into arcology inspired “Urban Monads”, 1000 floor skyscrapers, housing over 800,000 people, that as a community are almost entirely self-sufficient – they recycle everything obsessively, they capture body heat, every area of space is used to its full potential. The only thing they need is food from the farms – in exchange they maintain the machinery that the small farming community uses.
Because of the limited space, each apartment is one small room. The beds inflate and deflate down into the floor to ensure effective utilisation of the space. There’s no internal partitions (there is a privacy screen for the toilet, but it’s never used). There’s certainly no separate kitchen.
In our situation you can imagine tensions forming easily between people, so the rules are strict to ensure that peace is maintained – to ensure that no-one goes “flippo”. Sex (between any persons) is the main way of releasing any tension – and because minimising conflict is essential, it is seen as impolite (or even sinful) to refuse when someone asks, although the refusal is always accepted. The people in the UrbMon live in a ‘city’ – a group of about 50 or so floors, based roughly on class – administrators live up the top, whilst labourers live in the bottom-most city. The city forms the basis of their social group – it is rare that they interact with people outside of their own city – each ‘city’ even has its own entertainment complex.
Naturally because of the belief that reproduction is the highest good (the most “blessworthy”) it is common for marriages to happen at 12-13, as soon as the person is able to reproduce. Small families are also seen as a sign of failure – in Prague (one of the cities) there is an average of 9.9 children per family. This is not seen as freaky or weird, but is seen as something to be praised and upheld as a model of the family. This combined with the sexual permissiveness hinted at earlier, has given rise the the culture of “nightwalking”, one where men will roam the corridors of their city, and will go into an apartment (locks are forbidden as creating tensions and untrustworthyness), to have sex with the female (or male) there. There is no obligation for the other partner to leave, although they will usually go nightwalking themselves. Interestingly there is a social expectation that women don’t nightwalk, a source of tension for one of the characters in a later story when his wife leaves the room to seek out sex, not even waiting until night. (The horror!)
Due to the lack of privacy, sex happens within full view of the children. Indeed, one of the opening parts of the book is a song sung by children upon waking in the morning

God bless, god bless, god bless!
God bless us every one!
God bless Daddo, god bless Mommo,
god bless you and me!
God bless us all, the short and tall,
Give us fer-til-i-tee!

This opens the first short story in the collection – which tells, from the viewpoint of the father in this family, of the arrival and tour of a “sociocomputator” from a colony on Venus, where the social structure resembles our own much more closely – private dwellings in their own plot of land. He is somewhat shocked at the lack of privacy, at the invitation to “share” his hosts wife. At the age at which children are married.
To elaborate on that last point, once children become fertile they move into group dorms until a unit is available for themselves. Naturally, given the large number of people space is rare – there is a constant expansion programme of new UrbMons being built. One of the stories involves the conflict within one of those couples randomly chosen to go an live in the new UrbMon. They are so used to staying within their city, they are terrified of leaving all they know (no-one ever leaves an UrbMon by choice). But this is countered with the possibility of rising in social status; in established UrbMons the highest status jobs are rarely available for anyone to take, with people being groomed for the roles. In a new UrbMon however, the social mobility is much much greater.
Another of the key stories for understanding their culture is the one where someone, defying all social convention, leaves the UrbMon to explore. As he steps outside he is struck by how big the UrbMons are. But what is really telling is hwo he views the small agricultural commune that he encounters as he explores. At first he expects to be able to communicate with them, but as language is an issue he starts to view them as savages – especially when it appears that they are going to kill a pregnant member (which, given his culture is possibly the worst crime one could commit). But the distrust is mutual – the villagers believe he is there to spy on them.
One particularly noteworthy exchange is that with the old woman, when he tries to convince her that procreation is the best thing, he can’t understand why they stay so small – even as she points out that if they grew and expanded their commune, there wouldn’t be enough food for the UrbMons.
The final scene I’m going to highlight in this review is from the same story – it shows from our point of view, his attempt to rape the female; whilst from his point of view he thought she was just playing a game – having never been told no to his sexual advances. It wasn’t an easy read, but it was very valuable for showing how our experiences and social influences inform our beliefs and our actions.
And with that thought, I’m going to leave the review here. Suffice it to say, I highly recommend the book as an excellent read that provokes some serious thought about cultural norms, as well as alternative models of sustainability.