Toltec is a community-maintained repository of free software for the reMarkable tablet.
Warning: Toltec only supports OS builds up to and including OS 18.104.22.1686. 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
- My reMarkable seems to have become unresponsive, how do I fix it?
If you can’t SSH in through USB (using IP
10.11.99.1), 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