This section provides steps to complete the following basic setup tasks for a newly installed Clear Linux* OS system:

  • Create a new user.
  • Update the OS to its most current version using swupd.
  • Install the most common applications for system administrators and developers using bundles.
  • Set up a new user and add the new user to the wheel group.
  • Install a GUI to test sudo privileges.


Log in as the root user to complete the tasks in this section.

Create a new user

To create a new user and set a password for that user, enter the following commands as a root user:

useradd <userid>
passwd <userid>

Replace the <userid> with the name of the user account you want to create including the password for that user. The passwd command prompts you to enter a new password. Retype the new password for the new user account just created.

Install and update the OS software to its current version

Clear Linux OS has a unique application and architecture to add and update applications and to perform system updates called software update utility or swupd. Software applications are installed as bundles using the sub-command bundle-add.

The sysadmin-basic bundle installs the vast majority of applications useful to a system administrator. Install the sysadmin-basic bundle:

swupd bundle-add sysadmin-basic

We provide the full list of bundles and packages installed with the sysadmin-basic bundle. Additionally, we have listed all bundles for Clear Linux OS, active or deprecated. Click any bundle on the list to view the manifest of the bundle.

Set up a new user and add the new user to the wheel group

Before logging off as root and logging into your new user account, enable the sudo command for your new <userid>.

To be able to execute all applications with root privileges, add the <userid> to the wheel group.

  1. Add <userid> to the wheel group:

    usermod -G wheel -a <userid>
  2. Log out of root and into the new <userid>.

    To log off as root, enter exit.

    The command will bring you back to the login: prompt.

  3. Enter the new <userid> and the password created earlier.

    You will now be in the home directory of <userid>. The bundle sysadmin-basic contains the majority of applications that a system administrator would want, but it does not include a graphical user interface. The desktop bundle includes the GNOME* Display Manager and additional supporting applications.

Install a GUI to test sudo privileges


If you are following this sequence after just setting up the pre-configured VMware* virtual machine from the repo, you must increase virtual disk size or the following step will fail.

To test the sudo command and ensure it is set up correctly, install the GNOME Display Manager (gdm) and start it.

  1. To install the the GNOME Display Manager using swupd, enter the following command:

    sudo swupd bundle-add desktop
  2. To start the GNOME Display Manager, enter the following command:

    systemctl start gdm
  3. The system prompts you to authenticate the user. Enter the password for <userid>, and the GNOME Display Manager starts as shown in Figure 1:

    Gnome Desktop

    Figure 1: Gnome Desktop

  4. To start the GNOME Display Manager each time you start your system, enter the following command:

    systemctl enable gdm

Next steps

With your system now running Clear Linux OS, many opportunities exist.

Visit the tutorials page for examples on using your Clear Linux OS system.