Commit 4d2ca026 authored by David Boddie's avatar David Boddie

Add a quick ssh guide

Move a link to an issue into the common pool.
parent 5722e30d
......@@ -3,6 +3,35 @@
How To Guides
=============
This page contains short guides to help with common use cases and describe
how to perform routine tasks.
SSH Access and X11 Forwarding
-----------------------------
Once you have networking set up for the development board, you should be able
to log in using ``ssh`` once the OpenSSH daemon has started. This may take
some time due to a lack of entropy (see `linux-emcraft issue 2`_ for details).
Log in to the board using one of the network connections (Wi-Fi or Ethernet).
Install the ``xauth`` package to enable X11 forwarding and check that the
``/etc/ssh/sshd_config`` file contains the following line::
X11Forwarding yes
Log out and log in again using ``ssh -X`` and check that the environment has
the ``DISPLAY`` variable set.
To run a GNOME application, like `gnome-chess`, on the board while displaying
the output on a workstation running an X server, set the ``GDK_BACKEND``
environment variable [#]_ when running the executable, like this::
GDK_BACKEND=x11 gnome-chess
The application should appear on the workstation's screen.
.. [#] Described in the `Running GTK+ Applications`_ GNOME developer document.
USB Access
----------
......@@ -30,3 +59,5 @@ before following these steps.
3. Attach power to the USB C hub.
4. Plug in USB devices and they should appear in the output of the ``dmesg``
and ``lsusb`` tools.
.. include:: /links.rst
......@@ -85,4 +85,5 @@ whether user space software is in place to drive it.
.. _`Apps Issues`: https://source.puri.sm/Librem5/Apps_Issues
.. _`OS Issues`: https://source.puri.sm/Librem5/OS-issues
.. _`open devkit issues`: https://source.puri.sm/groups/Librem5/-/issues?scope=all&utf8=%E2%9C%93&state=opened&label_name%5B%5D=devkit
.. _`linux-emcraft issue 2`: https://source.puri.sm/Librem5/linux-emcraft/issues/2
.. include:: /links.rst
......@@ -29,9 +29,11 @@
.. _libhandy documentation : http://honk.sigxcpu.org/projects/libhandy/doc/
.. _libhandy website : https://source.puri.sm/Librem5/libhandy
.. _`linux-emcraft issue 2`: https://source.puri.sm/Librem5/linux-emcraft/issues/2
.. _`Meson`: https://mesonbuild.com/
.. _`Ninja`: https://ninja-build.org/
.. _`PureOS`: https://pureos.net
.. _`Running GTK+ Applications`: https://developer.gnome.org/gtk3/stable/gtk-running.html
.. _`FH34SRJ-6S-0.5SH(50) (Touch)`: https://www.hirose.com/product/download/?distributor=digikey&type=2d&lang=en&num=FH34SRJ-6S-0.5SH(50)
.. _`74LVC2G241DC,125`: https://assets.nexperia.com/documents/data-sheet/74LVC2G241.pdf
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment