= Running Transmission on a headless machine =
[[PageOutline]]

If you can give a clear description of the steps required for an undocumented platform, and provide a sample start/stop script, please [/newticket open a ticket] (set Component to Wiki).

== Setup ==
 1. After setting up your server and configuring it properly, you should install {{{transmission-daemon}}} either [wiki:"Building#OnUnix" "from source"], by downloading one of the [wiki:Binaries] or using your favorite package manager. Check if you can start [wiki:man/transmission-daemon transmission-daemon].
 1. Now we'll set up a new user called "{{{transmission}}}". For the sake of security you shouldn't set a password. Try:
{{{
$ adduser --disabled-password transmission
}}}
 1. Switch to the new user's shell and start transmission by calling 
{{{
$ sudo su transmission
}}}
 (or without sudo if you're root).
 1. Now start transmission by calling:
{{{
$ transmission-daemon -f
}}}
  Shut down the application after a few seconds by pressing {{{CRTL-C}}}.
 1. Configure it using your favorite text editor (see below)
 1. Copy the appropriate [wiki:Scripts/initd#StartStop init script] for your platform to their appropriate location
 1. Check that the new user's home folder is owned by the user transmission

== Configuration ==
There are two configuration files you can edit:
 * The [wiki:Scripts/initd#StartStop init script] (read the respective wiki page for more information)
 * Transmission [EditConfigFiles settings.json] file (eg. {{{/home/transmission/.config/transmission-daemon/settings.json}}} )

==== [wiki:Scripts/initd#StartStop init script] ====
Normally, there is no need to modify this file. However if you don't want to run transmission-daemon as user 'transmission', you'll need to change {{{USERNAME}}} to whatever user you want Transmission to run in.

If you've installed the Web Interface in a non standard location, you can set that path here too.

==== [EditConfigFiles settings.json] ====
''Note: Only if you've run Transmission once (and Transmission is closed) the [ConfigFiles configuration directory and files] will be created. As mentioned in [#Setup Setup], point 4.''

Normally, all settings are good-to-go out of the box. However, you'll want to look at setting a speed limit for your connection, and maybe you want to have Transmission downloading to a different location (default: {{{/home/transmission/Downloads}}}). Have a look at the [EditConfigFiles Editing Configuration Files] page.

== Using Transmission ==
You can use transmission in two ways now:
 * Use your system's init cli to start or stop Transmission
 * Let your system start Transmission on boot

Have a look at the [wiki:Scripts] page for more functionality.