# CLI Commands

Usage: `tvheadend [OPTIONS]`

### Generic Options <a href="#generic-options" id="generic-options"></a>

```
-h, --help                  Show this page
-v, --version               Show version infomation
```

### Service Configuration <a href="#service-configuration" id="service-configuration"></a>

```
-c, --config                Alternate configuration path
-B, --nobackup              Don't backup configuration tree at upgrade
-f, --fork                  Fork and run as daemon
-u, --user                  Run as user
-g, --group                 Run as group
-p, --pid                   Alternate PID path
-C, --firstrun              If no user account exists then create one with
                            no username and no password. Use with care as
                            it will allow world-wide administrative access
                            to your Tvheadend installation until you create or edit
                            the access control from within the Tvheadend web interface.
-U, --dbus                  Enable DBus
-e, --dbus_session          DBus - use the session message bus instead of the system one
-a, --adapters              Only use specified DVB adapters (comma-separated, -1 = none)
    --satip_bindaddr        Specify bind address for SAT>IP server
    --satip_rtsp            SAT>IP RTSP port number for server
                            (default: -1 = disable, 0 = webconfig, standard port is 554)
    --nosatip               Disable SAT>IP client (deprecated flag, use nosatipcli)
    --nosatipcli            Disable SAT>IP client
    --satip_xml             URL with the SAT>IP server XML location
```

### Server Connectivity <a href="#server-connectivity" id="server-connectivity"></a>

```
-6, --ipv6                  Listen on IPv6
-b, --bindaddr              Specify bind address
    --http_port             Specify alternative http port
    --http_root             Specify alternative http webroot
    --htsp_port             Specify alternative htsp port
    --htsp_port2            Specify extra htsp port
    --useragent             Specify User-Agent header for the http client
    --xspf                  Use xspf playlist instead M3U
```

### Debug Options <a href="#debug-options" id="debug-options"></a>

```
-d, --stderr                Enable debug on stderr
-n, --nostderr              Disable debug on stderr
-s, --syslog                Enable debug to syslog
-S, --nosyslog              Disable syslog (all messages)
-l, --logfile               Enable debug to file
    --debug                 Enable debug subsystems
    --trace                 Enable trace subsystems
    --subsystems            List subsystems
    --fileline              Add file and line numbers to debug
    --threadid              Add the thread ID to debug
    --libav                 More verbose libav log
    --uidebug               Enable web UI debug (non-minified JS)
-A, --abort                 Immediately abort
-D, --dump                  Enable coredumps for daemon
    --noacl                 Disable all access control checks
    --nobat                 Disable DVB bouquets
-j, --join                  Subscribe to a service permanently
```

### Testing Options

```
--tsfile_tuners         Number of tsfile tuners
--tsfile                tsfile input (mux file)
--tprofile              Gather timing statistics for the code
--thrdebug              Thread debugging
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tvheadend.org/documentation/appendices/cli-commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.