tvheadend/docs/html/install.html
Andrew C. Martin 7764b5618e documentation updates
- fix typos/misspellings in documentation
- fix broken link on how to build Tvheadend
- standardize on most commonly used capitalization of "Tvheadend"
- update copyright year to 2013
- break up the handful of run-on lines
2013-02-21 21:23:43 -07:00

86 lines
2.8 KiB
HTML

<div class="hts-doc-text">
Parts of this documentation is also available in the Tvheadend man page.
<p>
<dl>
<dt>Starting Tvheadend
<dd>
If you already have Tvheadend up and running you can skip this part.
<p>
Command line options:
<dl>
<dt>-f
<dd>
Fork and become a background process (daemon). Default no.
<dt>-u username
<dd>
Run as 'username'. Only applicable if demonizing. Default is to
use the UID of 1 (daemon on most systems).
<dt>-g groupname
<dd>
Run as group 'groupname'. Only applicable if daemonizing.
Default is to use the 'video' group.
If the 'video' group does not exist, GID 1 (daemon) will be used.
</dl>
<dt>Default configuration
<dd>
All configuration in Tvheadend is maintained via its embedded web
server running on port 9981. Just point your browser to:
<p>
http://hostname:9981/
<p>
By default <b>everyone (also from remote hosts)is allowed full
access to all features / settings</b> in the web user interface. If
this is the first time you setup Tvheadend you are most encouraged to
enter the web user interface, selected the 'Configuration' + 'Access Control'
tab and make reasonable changes. Further help / documentation can be obtained
inside the web interface.
<dt>Settings storage
<dd>
Settings are loaded/stored in $HOME/.hts/tvheadend.
<dt>Logging
<dd>
All activity inside Tvheadend is logged to syslog using log facility.
Also, if logged in to the web interface you will receive the same log in the bottom
tab (System log).
<dt>Permission to access video adapters
<dd>
In order for Tvheadend to control video adapters on the system it
must be granted access to those devices. Most systems have a 'video'
group with write access to the video adapter devices. When Tvheadend
is started as a daemon (if Tvheadend is installed from a distribution package
this is most likely the way it is) it will change its primary group
to 'video' in order to access these groups. If your system is configured
in a different way you can either change the group membership of the
video adapters (/dev/dvb, etc) or reconfigure the Tvheadend start up
parameters.
<p>
If Tvheadend is started without the '-f' argument it will not demonize
nor change its primary UID/GID. Rather it will run with the permissions
granted to the user executing the binary. If that's the case you must make
sure the current user is granted with access to the video devices.
<dt>Open ports
<dd>
Tvheadend listens to the following TCP ports by default:
<ul>
<li>9981 - HTTP server (web interface)
<li>9982 - HTSP server (Streaming protocol)
</ul>
There is currently no way of disabling these TCP servers, nor bind the services to
specific interfaces or other ports.
To limit access, please read the section about 'Access Control'
in the configuration chapter.
</dl>
</div>