Toltec is a community-maintained repository of free software for the reMarkable tablet.

Install Toltec#

⚠️ Warning: Toltec does not support OS builds newer than 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.

To install Toltec, connect your reMarkable to Wi-Fi and paste the following lines in an SSH session:

wget http://toltec-dev.org/bootstrap
echo "04a28483286f88c5c7f39e352afb62adc57f6162a29fd7e124d832205bb0980e  bootstrap" | sha256sum -c && bash bootstrap

What Does Toltec Do?#

Toltec gives you access to all the packages from the Entware and Toltec repositories. Toltec keeps track of which apps you have installed and makes it easy to update or remove them.

Use the opkg command to add, remove, and update packages from the command line.

opkg update
opkg upgrade
opkg install <package>
opkg remove <package>
opkg info <package>

Or install nao to manage packages using a graphical interface.


Use the toltecctl command to manage your Toltec install.

toltecctl help
toltecctl reenable
toltecctl uninstall
toltecctl switch-branch testing

To seamlessly switch between apps, start by installing a launcher.

Browse Toltec packages Browse Entware packages

Frequently Asked Questions#

Where can I get help?

If you need help with Toltec or one of its packages, you can start a discussion on GitHub or join the reMarkable community on Discord. Please do not open issues to ask for help, as they’re used exclusively for package requests and bug reports.

Is this supported by reMarkable AS?

No, this is a community project.

Will this brick my reMarkable?

Probably not, but standard disclaimers apply.

Do you support reMarkable 2?

Yes, Toltec will automatically detect whether you are using a reMarkable 1 or 2, and install the required framebuffer dependencies.

Can I add __________ to Toltec?

We’re always open to adding new packages to the repository. You’ll find information about how to add a package in our contributing guide.

I found a vulnerability in Toltec or one of its packages, where can I report it?

To inform the Toltec maintainers about a security issue, please follow the security instructions.

Can I factory reset my reMarkable if I have toltec installed?

No, DO NOT factory reset your reMarkable if you have toltec installed. First uninstall toltec with toltecctl uninstall.

My reMarkable seems to have become unresponsive, how do I fix it?

If you can’t SSH in through USB (using IP, there are tools that can help you recover your reMarkable if it becomes unresponsive:

If you can SSH in through USB, the following may work:

rm /etc/systemd/system/xochitl.service.d/toltec-wrapper.conf
systemctl daemon-reload
systemctl reset-failed xochitl
systemctl restart xochitl