mirror of
https://github.com/freedombox/FreedomBox.git
synced 2026-01-21 07:55:00 +00:00
5 lines
13 KiB
XML
5 lines
13 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!DOCTYPE article
|
|
PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'
|
|
'http://www.docbook.org/xml/4.4/docbookx.dtd'>
|
|
<article><articleinfo><title>FreedomBox/Manual/Cockpit</title><revhistory><revision><revnumber>2</revnumber><date>2019-01-10 21:41:56</date><authorinitials>SunilMohanAdapa</authorinitials><revremark>Write manual page for Cockpit</revremark></revision><revision><revnumber>1</revnumber><date>2018-03-02 12:57:48</date><authorinitials>JosephNuthalapati</authorinitials><revremark>Create stub for Cockpit</revremark></revision></revhistory></articleinfo><section><title>Cockpit (Server Administration)</title><para>Cockpit is a server manager that makes it easy to administer GNU/Linux servers via a web browser. On a FreedomBox, controls are available for many advanced functions that are not usually required. A web based terminal for console operations is also available. </para><para>It can be accessed by any user on your FreedomBox belonging to the admin group. </para><caution><para>Use cockpit only if you are an administrator of GNU/Linux systems with advanced skills. FreedomBox tries to coexist with changes to system by system administrators and system administration tools like Cockpit. However, improper changes to the system might causes failures in FreedomBox functions. </para></caution><section><title>Using Cockpit</title><para>Install Cockpit like any other application on FreedomBox. Make sure that Cockpit is enabled after that. </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-enable.png"/></imageobject><textobject><phrase>cockpit-enable.png</phrase></textobject></inlinemediaobject> </para><para>Ensure that the user account on FreedomBox that will used for Cockpit is part of the administrators group. </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-admin-user.png"/></imageobject><textobject><phrase>cockpit-admin-user.png</phrase></textobject></inlinemediaobject> </para><para>Launch the Cockpit web interface. Login using the configured user account. </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-login.png"/></imageobject><textobject><phrase>cockpit-login.png</phrase></textobject></inlinemediaobject> </para><para>Start using cockpit. </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-system.png"/></imageobject><textobject><phrase>cockpit-system.png</phrase></textobject></inlinemediaobject> </para><para>Cockpit is usable on mobile interfaces too. </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-mobile.png"/></imageobject><textobject><phrase>cockpit-mobile.png</phrase></textobject></inlinemediaobject> </para></section><section><title>Features</title><para>The following features of Cockpit may be useful for advanced FreedomBox users. </para><section><title>System Dashboard</title><para>Cockpit has a system dashboard that </para><itemizedlist><listitem><para>Shows detailed hardware information </para></listitem><listitem><para>Shows basic performance metrics of a system </para></listitem><listitem><para>Allows changing system time and timezone </para></listitem><listitem><para>Allows changing hostname. Please use FreedomBox UI to do this </para></listitem><listitem><para>Shows SSH server fingerprints </para></listitem></itemizedlist><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-system.png"/></imageobject><textobject><phrase>cockpit-system.png</phrase></textobject></inlinemediaobject> </para></section><section><title>Viewing System Logs</title><para>Cockpit allows querying system logs and examining them in full detail. </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-logs.png"/></imageobject><textobject><phrase>cockpit-logs.png</phrase></textobject></inlinemediaobject> </para></section><section><title>Managing Storage</title><para>Cockpit allows following advanced storage functions: </para><itemizedlist><listitem><para>View full disk information </para></listitem><listitem><para>Editing disk partitions </para></listitem><listitem><para>RAID management </para></listitem></itemizedlist><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-storage1.png"/></imageobject><textobject><phrase>cockpit-storage1.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-storage2.png"/></imageobject><textobject><phrase>cockpit-storage2.png</phrase></textobject></inlinemediaobject> </para></section><section><title>Networking</title><para>Cockpit and FreedomBox both rely on NetworkManager to configure the network. However, Cockpit offers some advanced configuration not available on FreedomBox: </para><itemizedlist><listitem><para>Route configuration </para></listitem><listitem><para>Configure Bonds, Bridges, VLANs </para></listitem></itemizedlist><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-network1.png"/></imageobject><textobject><phrase>cockpit-network1.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-network2.png"/></imageobject><textobject><phrase>cockpit-network2.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-network3.png"/></imageobject><textobject><phrase>cockpit-network3.png</phrase></textobject></inlinemediaobject> </para></section><section><title>Services</title><para>Cockpit allows management of services and periodic jobs (similar to cron). </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-services1.png"/></imageobject><textobject><phrase>cockpit-services1.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-services2.png"/></imageobject><textobject><phrase>cockpit-services2.png</phrase></textobject></inlinemediaobject> </para></section><section><title>Web Terminal</title><para>Cockpit offers a web based terminal that can be used perform manual system administration tasks. </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/FreedomBox/Manual/Cockpit?action=AttachFile&do=get&target=cockpit-terminal.png"/></imageobject><textobject><phrase>cockpit-terminal.png</phrase></textobject></inlinemediaobject> </para><para>Back to <ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Features#">Features introduction</ulink> or <ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Manual#">manual</ulink> pages. </para><!--rule (<hr>) is not applicable to DocBook--><informaltable><tgroup cols="8"><colspec colname="col_0"/><colspec colname="col_1"/><colspec colname="col_2"/><colspec colname="col_3"/><colspec colname="col_4"/><colspec colname="col_5"/><colspec colname="col_6"/><colspec colname="col_7"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis role="strong">Information</emphasis></para></entry><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"><para><emphasis role="strong">Support</emphasis></para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong">Contribute</emphasis></para></entry><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"><para><emphasis role="strong">Reports</emphasis></para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong">Promote</emphasis></para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Introduction#">Overview</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Hardware#">Hardware</ulink> </para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong"> </emphasis></para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Support#">Live Help</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Contribute#">Where To Start</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Translate#">Translate</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/ProgressCalls#">Calls</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/TalksAndPresentations#">Talks</ulink> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Features#">Features</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Vision#">Vision</ulink> </para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong"> </emphasis></para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/QuestionsAndAnswers#">Q&A</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Design#">Design</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/TODO#">To Do</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/ReleaseNotes#">Releases</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Press#">Press</ulink> </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Download#">Download</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Manual#">Manual</ulink> </para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong"> </emphasis></para></entry><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Contribute/Code#">Code</ulink> </para></entry><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Contributors#">Contributors</ulink> </para></entry><entry colsep="1" rowsep="1"/><entry colsep="1" rowsep="1"><para><ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox/Blog#">Blog</ulink> </para></entry></row></tbody></tgroup></informaltable><para><!--"~-smaller-~" is not applicable to DocBook-->HELP & DISCUSSIONS: <ulink url="https://discuss.freedombox.org">Discussion Forum</ulink> - <ulink url="https://lists.alioth.debian.org/mailman/listinfo/freedombox-discuss">Mailing List</ulink> - <ulink url="irc://irc.debian.org/freedombox">#freedombox irc.debian.org</ulink> | CONTACT <ulink url="https://freedomboxfoundation.org/">Foundation</ulink> | JOIN <ulink url="https://salsa.debian.org/freedombox-team/">Project</ulink> </para><para><link linkend="">Next call</link>: Sunday, May 25th at 17:00 UTC </para><para><link linkend="">Latest news</link>: Announcing Pioneer <ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/FreedomBox#">FreedomBox</ulink> Kits - 2019-03-26 </para><para>This page is copyright its contributors and is licensed under the <ulink url="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)</ulink> license. </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="https://wiki.debian.org/FreedomBox/Manual/Cockpit/CategoryFreedomBox#">CategoryFreedomBox</ulink> </para></section></section></section></article> |