Frequently Asked Questions#
What kind of telemetry do you have?#
As of 2.4, Oxide has opt-in basic telemetry. The first time you run Oxide you’ll be asked what level of telemetry you’d like to enable. This feature can be disabled at runtime, or completely removed when compiling the application manually. The telemetry is used for the following:
Automated crash reporting.
Determining how quickly new versions are used by users.
Determining what older versions are still in use.
What kind of information is collected by telemetry?#
- The device machine-id, but anonymised through
sd_id128_get_boot_app_specific. This is used to uniquely identify the devices connecting so that I can properly determine what percentage of devices are on specific versions. It can also allow me to determine what crash reports are sent by a user if they are willing to share the anonymised value from their devices.
- OS version via the contents of
/etc/version
on the device. This helps ensure that the OS version is properly taken into account when investigating a crash.
- OS version via the contents of
- Name of application and version. i.e.
rot@2.4
This ensures that the correct application is investigated for a crash.
- Name of application and version. i.e.
- Minidump of the crash.
This hopefully provides enough information that a crash can be replicated and the specific piece of code that is causing issues can be identified.
How can I disable the telemetry?#
rot settings set telemetry false
rot settings set crashReport false
rot settings set applicationUsage false
Or you can compile the applications manually without the sentry
feature enabled.
How can I get the time to display in my timezone?#
You can use timedatectl
to change your timezone. You can see available timezones by looking into /usr/share/zoneinfo/
.
Do not trust the output of timedatectl get-timezones
as it reports more timezones than are
actually installed on the device by default. You can install more timezones on the device through
Toltec by installing one of the zoneinfo-*
packages.
timedatectl set-timezone America/Denver
I’m installing without Toltec and nothing displays?#
Oxide (and most other applications) on the reMarkable 2 requires rm2fb do display to the screen.
How do I change my pin after I’ve set it?#
There is no way to currently trigger a pin change, but you can wipe your current pin, and trigger the pin setting dialog by doing the following:
systemctl stop tarnish
rm /home/root/.config/Eeems/decay.conf
systemctl start tarnish
Not all of my applications are listed?#
Oxide doesn’t import draft applications automatically, you can import them by using the menu on the
top left of the launcher. If your application is still not listed, you may need to review the device
logs to determine why it’s failing to load. If an application is configured in draft to pass arguments
in the call=
line, it will fail to import as this is not supported by Oxide.
How do I review my device logs?#
Most logs on the device are accessable from the command line through journalctl. To get at the logs for Oxide’s programs, and any application you run through Oxide, you can run the following:
journalctl -eau tarnish
Where are the configuration files?#
The primary configuration file can be found in one of the following locations:
/etc/oxide.conf
/opt/etc/oxide.conf
/home/root/.config/oxide.conf
Other configuration files can be found in /home/root/.config/Eeems/
.