====== Setting up DVR storage on a Linux-based device ======
<btn type="success" size="xs" icon="fa fa-chevron-left">[[:DVR|Go back to all DVR topics]]</btn>\\
<btn type="success" size="xs" icon="fa fa-chevron-left">[[:Linux|For other linux-related topics]]</btn>\\
<lead>This page will describe how to set up the DVR storage software on a linux-based operating system.</lead>

===== Requirements =====
<WRAP indent>

**Before you continue, make sure you have the following:**

  * [[DVR:subscription|HDHomeRun DVR subscription]]
  * One or more compatible HDHomeRun device: see **[[:dvr tuners|List of DVR compatible HDHomeRun devices]]**
  * A recent and supported release of Debian or Ubuntu.
  * Wired network connection. The DVR will handle a great deal of video traffic, so wireless connections should be avoided.

</WRAP>


===== Manual install instructions =====
<WRAP indent>

The following instructions are for manual install and configuration of the HDHomeRun RECORD engine on a Linux machine. These instructions are intended for experienced users who want to experiment.


  - Create a folder for recordings. For example from the command line you could do, <code>mkdir HDHomeRun</code> which will create a folder called "HDHomeRun" in your default user directory.
  - Enter the new folder: <code>cd HDHomeRun</code>
  - Download the latest HDHomeRun RECORD for Linux release using the wget command or a desktop GUI/browser
    * Debian/Ubuntu:
        * Stable: https://download.silicondust.com/hdhomerun/hdhomerun_record_linux
        * Beta: https://download.silicondust.com/hdhomerun/hdhomerun_record_linux_beta
    * BSD-based (FreeBSD, FreeNAS)
        * Stable: https://download.silicondust.com/hdhomerun/hdhomerun_record_freebsd
        * Beta: https://download.silicondust.com/hdhomerun/hdhomerun_record_freebsd_beta
    * For example, the command might look like this <code>wget https://download.silicondust.com/hdhomerun/hdhomerun_record_linux</code>
  - Copy to the recordings folder and rename "hdhomerun_record".
    * <code>mv hdhomerun_record_linux hdhomerun_record</code>
  - Create a configuration file hdhomerun.conf in the recordings folder. Add the line: <code>RecordPath=<full Linux path to recordings folder></code>
    - To do this from the command line, use the command<code>nano hdhomerun.conf</code>
    - for this example we will write in **RecordPath=/home/<USERNAME GOESE HERE>/HDHomeRun/** for a Debian-based system
    - press control key+x to exit, then press Y then enter to save.
  - Make the file executable: <code>chmod +x hdhomerun_record</code>
  - Start the HDHomeRun RECORD engine:<code>./hdhomerun_record start

./hdhomerun_record status</code>
  - To start from a different directory: <code>
/<path to recording folder>/hdhomerun_record start --conf /<path to recording folder>/hdhomerun.conf

/<path to recording folder>/hdhomerun_record status</code>
  - <wrapper>Check the log file.
The progress release builds of the record engine generate detailed log files by default. The log files are placed in the HDHomeRun directory and are named YYYYMMDD.log (UTC time). Note that all timestamps in the log files are in UTC time, not local time.

No log file - this usually means the record engine was not able to find the config file, was not able to find RecordPath in the config file, or the path specified doesn't exist.</wrapper>

</WRAP>
===== Next step: Using DVR in the HDHomeRun app =====
<WRAP indent>

Once you finish setting up a DVR storage device, see our guide link below for instructions on using the DVR features in the HDHomeRun app.\\
<btn type="success" size="lg" icon="fa fa-book">[[:app|Instructions on using the DVR features in the HDHomeRun app]]</btn>

</WRAP>

{{tag>DVR linux}}