Files
clear-linux-documentation/guides/maintenance/enable-user-space.html
2024-11-04 18:48:51 +00:00

218 lines
12 KiB
HTML

<!DOCTYPE html>
<html lang="en" data-content_root="../../">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Create and enable a new user space &#8212; Documentation for Clear Linux* project</title>
<link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../../_static/bizstyle.css?v=5283bb3d" />
<link rel="stylesheet" type="text/css" href="../../_static/copybutton.css?v=76b2166b" />
<script src="../../_static/documentation_options.js?v=5929fcd5"></script>
<script src="../../_static/doctools.js?v=9bcbadda"></script>
<script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../_static/clipboard.min.js?v=a7894cd8"></script>
<script src="../../_static/copybutton.js?v=a56c686a"></script>
<script src="../../_static/bizstyle.js"></script>
<link rel="canonical" href="https://clearlinux.github.io/clear-linux-documentation/guides/maintenance/enable-user-space.html" />
<link rel="icon" href="../../_static/favicon.ico"/>
<link rel="author" title="About these documents" href="../../about.html" />
<link rel="index" title="Index" href="../../genindex.html" />
<link rel="search" title="Search" href="../../search.html" />
<link rel="next" title="Fix a broken installation" href="fix-broken-install.html" />
<link rel="prev" title="Enable systemd-boot Menu" href="enable-systemd-boot-menu.html" />
<meta name="viewport" content="width=device-width,initial-scale=1.0" />
<!--[if lt IE 9]>
<script src="_static/css3-mediaqueries.js"></script>
<![endif]-->
</head><body>
<div class="related" role="navigation" aria-label="Related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="fix-broken-install.html" title="Fix a broken installation"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="enable-systemd-boot-menu.html" title="Enable systemd-boot Menu"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../../index.html">Documentation for Clear Linux* project</a> &#187;</li>
<li class="nav-item nav-item-1"><a href="../index.html" accesskey="U">Guides</a> &#187;</li>
<li class="nav-item nav-item-this"><a href="">Create and enable a new user space</a></li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<section id="create-and-enable-a-new-user-space">
<span id="enable-user-space"></span><h1>Create and enable a new user space<a class="headerlink" href="#create-and-enable-a-new-user-space" title="Link to this heading"></a></h1>
<p>This guide provides steps to complete the following basic setup tasks for
a newly installed Clear Linux* OS system:</p>
<nav class="contents local" id="contents">
<ul class="simple">
<li><p><a class="reference internal" href="#create-a-new-user" id="id1">Create a new user</a></p></li>
<li><p><a class="reference internal" href="#add-the-new-user-to-the-wheel-group" id="id2">Add the new user to the <em>wheel</em> group</a></p></li>
<li><p><a class="reference internal" href="#install-and-update-the-os-software-to-its-current-version" id="id3">Install and update the OS software to its current version</a></p></li>
<li><p><a class="reference internal" href="#add-a-bundle" id="id4">Add a bundle</a></p></li>
<li><p><a class="reference internal" href="#next-steps" id="id5">Next steps</a></p></li>
</ul>
</nav>
<section id="create-a-new-user">
<h2><a class="toc-backref" href="#id1" role="doc-backlink">Create a new user</a><a class="headerlink" href="#create-a-new-user" title="Link to this heading"></a></h2>
<p>To create a new user and set a password for that user, enter the following
commands as a root user:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>useradd<span class="w"> </span>&lt;userid&gt;
passwd<span class="w"> </span>&lt;userid&gt;
</pre></div>
</div>
<p>Replace the &lt;userid&gt; with the name of the user account you want to create
including the password for that user. The <strong class="command">passwd</strong> command prompts
you to enter a new password. Retype the new password for the new user
account just created.</p>
</section>
<section id="add-the-new-user-to-the-wheel-group">
<h2><a class="toc-backref" href="#id2" role="doc-backlink">Add the new user to the <em>wheel</em> group</a><a class="headerlink" href="#add-the-new-user-to-the-wheel-group" title="Link to this heading"></a></h2>
<p>Before logging off as root and logging into your new user account,
enable the <strong class="command">sudo</strong> command for your new &lt;userid&gt;.</p>
<p>To be able to execute all applications with root privileges, add the
&lt;userid&gt; to the <a class="reference external" href="https://en.wikipedia.org/wiki/Wheel_(Unix_term)">wheel group</a>.</p>
<ol class="arabic">
<li><p>Add &lt;userid&gt; to the wheel group:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>usermod<span class="w"> </span>-G<span class="w"> </span>wheel<span class="w"> </span>-a<span class="w"> </span>&lt;userid&gt;
</pre></div>
</div>
</li>
<li><p>Log out of root and into the new &lt;userid&gt;.</p>
<p>To log off as root, enter <strong class="command">exit</strong>.</p>
</li>
<li><p>Enter the new &lt;userid&gt; and the password created earlier.</p>
<p>You will now be in the home directory of &lt;userid&gt;.</p>
</li>
</ol>
</section>
<section id="install-and-update-the-os-software-to-its-current-version">
<h2><a class="toc-backref" href="#id3" role="doc-backlink">Install and update the OS software to its current version</a><a class="headerlink" href="#install-and-update-the-os-software-to-its-current-version" title="Link to this heading"></a></h2>
<p>The Clear Linux OS software utility <a class="reference internal" href="../clear/swupd.html#swupd-guide"><span class="std std-ref">swupd</span></a> allows you to perform
system updates while reaping the benefits of upstream development.</p>
<p>To update your newly installed OS, run:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>swupd<span class="w"> </span>update
</pre></div>
</div>
</section>
<section id="add-a-bundle">
<h2><a class="toc-backref" href="#id4" role="doc-backlink">Add a bundle</a><a class="headerlink" href="#add-a-bundle" title="Link to this heading"></a></h2>
<p>Software applications are installed as bundles using the command
<strong class="command">swupd bundle-add</strong>. Experienced Linux users might compare swupd
to running <strong class="command">apt-get</strong> or <strong class="command">yum install</strong> for package
management. However Clear Linux OS manages packages at the level of bundles, which
are integrated stacks of packages.</p>
<p>For example, the <strong class="command">sysadmin-basic</strong> bundle installs the majority of
applications useful to a system administrator. To install it, enter:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>swupd<span class="w"> </span>bundle-add<span class="w"> </span>sysadmin-basic
</pre></div>
</div>
<p>View a full list of bundles and packages installed with the <a class="reference external" href="https://github.com/clearlinux/clr-bundles/blob/master/bundles/sysadmin-basic">sysadmin-basic</a>
bundle. You can also view all <a class="reference external" href="https://github.com/clearlinux/clr-bundles/tree/master/bundles">bundles</a> for Clear Linux OS, active or deprecated.</p>
<p>Expand your knowledge of <strong class="command">swupd</strong> and check out our developer resources:</p>
<ul class="simple">
<li><p><a class="reference internal" href="../clear/swupd.html#swupd-guide"><span class="std std-ref">swupd</span></a></p></li>
<li><p><a class="reference internal" href="developer-workstation.html#developer-workstation"><span class="std std-ref">Developer Workstation</span></a></p></li>
</ul>
</section>
<section id="next-steps">
<h2><a class="toc-backref" href="#id5" role="doc-backlink">Next steps</a><a class="headerlink" href="#next-steps" title="Link to this heading"></a></h2>
<p>Check out our guides and tutorials.</p>
<ul class="simple">
<li><p><a class="reference internal" href="../index.html#guides"><span class="std std-ref">Guides</span></a></p></li>
<li><p><a class="reference internal" href="../../tutorials/index.html#tutorials"><span class="std std-ref">Tutorials</span></a></p></li>
</ul>
</section>
</section>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="Main">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="../../index.html">
<img class="logo" src="../../_static/clearlinux.png" alt="Logo of Clear Linux* Project Docs"/>
</a></p>
<div>
<h3><a href="../../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Create and enable a new user space</a><ul>
<li><a class="reference internal" href="#create-a-new-user">Create a new user</a></li>
<li><a class="reference internal" href="#add-the-new-user-to-the-wheel-group">Add the new user to the <em>wheel</em> group</a></li>
<li><a class="reference internal" href="#install-and-update-the-os-software-to-its-current-version">Install and update the OS software to its current version</a></li>
<li><a class="reference internal" href="#add-a-bundle">Add a bundle</a></li>
<li><a class="reference internal" href="#next-steps">Next steps</a></li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="enable-systemd-boot-menu.html"
title="previous chapter">Enable systemd-boot Menu</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="fix-broken-install.html"
title="next chapter">Fix a broken installation</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../../_sources/guides/maintenance/enable-user-space.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<search id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</search>
<script>document.getElementById('searchbox').style.display = "block"</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="Related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../../genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="fix-broken-install.html" title="Fix a broken installation"
>next</a> |</li>
<li class="right" >
<a href="enable-systemd-boot-menu.html" title="Enable systemd-boot Menu"
>previous</a> |</li>
<li class="nav-item nav-item-0"><a href="../../index.html">Documentation for Clear Linux* project</a> &#187;</li>
<li class="nav-item nav-item-1"><a href="../index.html" >Guides</a> &#187;</li>
<li class="nav-item nav-item-this"><a href="">Create and enable a new user space</a></li>
</ul>
</div>
<div class="footer" role="contentinfo">
&#169; Copyright 2022 Intel Corporation. All Rights Reserved..
Last updated on Nov 04, 2024.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.1.3.
</div>
</body>
</html>