cleanup content

parent cb403e43
......@@ -2,4 +2,7 @@
Glossary
========
genindex placeholder
* `genindex` placeholder
* will be replaced through genindex output by ``sphinx-build``
* even though this site is required to get the desired menu entry
......@@ -12,10 +12,14 @@ For other, seldom used settings we used so called `Custom JSON` fields.
There are two differente `Custom JSON` fields available depending on the layer of your desired configuration.
.. hint::
Please make sure that you use the provided configurations on the approrpiate layer which we indicate in each example.
Please make sure that you use the provided configurations on the appropriate level which we indicate in each example.
Server Level
============
.. index::
triple: Server; Custom JSON; Server Level
.. _server-customjson_server:
Server Level Configuration
==========================
The server level `Custom JSON` is located on the servers `System` tab. It is used to influence the servers configurations,
for example to
......@@ -27,8 +31,12 @@ for example to
You can add entries to the servers hosts file for testing or other
purposes (e.g. TYPO3 page not found handling, APIs) like this:
Website Level
=============
.. index::
triple: Server; Custom JSON; Website Level
.. _server-customjson_website:
Website Level Configuration
===========================
The website level `Custom JSON` is located on the particular websites `Advanced` tab. It is used to influence the websites configurations,
for example to
......
......@@ -8,11 +8,12 @@ Here, we document possible configuration options which you won't need on a daily
:maxdepth: 1
customjson
database
firewall
postfix
globalrepo
ftp
database
hosts
postfix
ssh
ca-certificates
ftp
.. index::
twin: Server; SSH Client Configuration
.. _server-ssh:
========================
SSH client configuration
========================
You can add custom SSH client configurations to ``/etc/ssh/ssh_config``
by setting the ``ssh::config`` hash within the Custom JSON :ref:`server-customjson_server`:
.. code-block:: json
{
"ssh::config": {
"Host": "git",
"HostName": "code.example.com",
"User": "git"
}
}
.. Hint::
use ``man ssh_config`` (`online version <http://man.openbsd.org/ssh_config>`_) for available configuration options
......@@ -23,11 +23,16 @@ Shortcuts and sudo configuration
Depending on the installed services, some shortcuts are available to execute certain commands with root privileges.
You will find a list of all shortcuts by typing ``help``.
Generic ``devop`` user
----------------------
.. index::
triple: Server; Access; devop
.. _server-access-devop:
Generic admin user
------------------
A user named ``devop`` is created by default. You can log into the server
with this user for debugging purposes or to execute some global tasks:
A user named `devop` is created by default. You can log into the server
with this user for debugging purposes and to execute global tasks which are not
allowed to the website users:
* read access to all system log files in ``/var/log/``
* read access to nginx vhosts in ``/etc/nginx/websites/``
......@@ -41,24 +46,6 @@ with this user for debugging purposes or to execute some global tasks:
.. hint:: use the ``lnav`` utility to display logs in a meaningful way (``lnav ~/log/`` as website user, ``lnav`` as ``devop`` user for global logs)
SSH client configuration
------------------------
Add client configurations to ``/etc/ssh/ssh_config`` by setting the
``ssh::config`` hash:
.. code-block:: json
{
"ssh::config": {
"Host": "git",
"HostName": "code.example.com",
"User": "git"
}
}
.. Hint:: use ``man ssh_config`` (`online version <http://man.openbsd.org/ssh_config>`_) for available configuration options
SFTP
----
......
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