Root access

(notes about debugging ssh connections and xauth needed for X forwarding)
(OpenSSH: Remove bit about securing root access since it's done on install)
Line 20: Line 20:
# [[Extras|Enable Extras]] (if you haven't already).
# [[Extras|Enable Extras]] (if you haven't already).
# Install OpenSSH (client and server).
# Install OpenSSH (client and server).
 +
** This will prompt you to change the root password from the default, <code>rootme</code>.
# SSH into your tablet as root
# SSH into your tablet as root
#* For local access, run <code>ssh root@localhost</code>
#* For local access, run <code>ssh root@localhost</code>
#* For remote access, run <code>ssh root@''tablet's ip address''</code>
#* For remote access, run <code>ssh root@''tablet's ip address''</code>
-
# Use the root password that the OpenSSH package asked you to enter to log in (in ancient OS versions you had to use the factory default "rootme" password).
+
# Use the root password entered at step (2) to log in.
To debug issues with SSH connections, use the SSH '-v' option.
To debug issues with SSH connections, use the SSH '-v' option.
-
(To get SSH X forwarding ('-X' option) to work, you need to install ''xauth'' (or ''xbase-clients'') package and enable X forwarding in the SSH server
+
(To get SSH X forwarding ('-X' option) to work, you need to install ''xauth'' (or ''xbase-clients'') package and enable X forwarding in the SSH server configuration file on the machine where you're connecting to.)
-
configuration file on the machine where you're connecting to.)
+
-
 
+
-
=== Securing root access ===
+
-
 
+
-
At this point you should have gained root access to your device, and be looking at the root prompt:
+
-
 
+
-
<nowiki>#</nowiki>
+
-
 
+
-
'''However, if your Wi-Fi network is not password protected, so might anyone else near you who has Wi-Fi, SSH and a clue.'''
+
-
 
+
-
You still need to secure the root account ("rootme" is a terrible password).
+
-
 
+
-
==== Change root password ====
+
-
<small>''Note: The OpenSSH requires that the root password be set as part of its installation process, if you have installed OpenSSH you have already completed this step''</small>
+
-
 
+
-
To change root password (as root user):
+
-
 
+
-
passwd
+
-
 
+
-
When asked, input your [http://en.wikipedia.org/wiki/Password_strength new password] twice.
+
== R&amp;D Mode ==
== R&amp;D Mode ==

Revision as of 11:20, 11 August 2008

Warning: The steps described on this page could lead to severe damage to your system and/or device. Proceed at your own peril. It is likely that any breakage would be fixed by reflashing your device: however this will lose any settings not backed up.

Having root access is an important step for users interested in modifying things "under the covers" of their tablets; without it, you wont have the necessary permissions to make those modifications. Unfortunately, root access is disabled by default on new tablets. Thankfully, the steps to enable root access are simple.

Contents

Why do I want root?

root access is not required to install additional applications through Application Manager, open X Terminal or use your tablet in day-to-day operation.

If you want to edit the underlying system configuration, install applications through the command line or other low-level tasks, you will require root access.

rootsh

Note: As rootsh is the simplest option, and does not require a desktop computer or running additional services, it is the recommended method for gaining root access.

rootsh is available in Extras, and can be installed from the Application manager if you have Extras enabled.

Then, from the shell, run sudo gainroot (or root for short). This will give you a root shell.

OpenSSH

  1. Enable Extras (if you haven't already).
  2. Install OpenSSH (client and server).
    • This will prompt you to change the root password from the default, rootme.
  1. SSH into your tablet as root
    • For local access, run ssh root@localhost
    • For remote access, run ssh root@tablet's ip address
  2. Use the root password entered at step (2) to log in.

To debug issues with SSH connections, use the SSH '-v' option.

(To get SSH X forwarding ('-X' option) to work, you need to install xauth (or xbase-clients) package and enable X forwarding in the SSH server configuration file on the machine where you're connecting to.)

R&D Mode

Note: As R&D mode has other side effects beyond simply enabling root access (including several that may negatively impact battery life), it is not the recommended method for gaining root access. Use rootsh instead.

You can enable the Research & Development mode (R&D or RD mode, which enables you to execute sudo gainroot to get a root shell, simply follow the setup steps for flashing covered in Upgrading tablet OS, then execute

sudo ./flasher-3.0 --enable-rd-mode -R

You are now in R&D mode, and the sudo gainroot script's check will be satisfied.