||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents(3)>>||
<<Include(MythTV/Header)>>

= mythv-setup =
{{{mythtv-setup}}} is the binary used for the initial configuration of a MythTV backend.  It is QT based and needs to be launched on an X server (not necessarily on the machine that the backend is running on).

== X-Forwarding mythtv-setup ==
If the backend machine that is being setup doesn't have an X server, {{{mythtv-setup}}} can be launched remotely through a ssh connection that has X forwarded over it.  It can be run on windows machine running Cygwin/X, a linux/unix machine running xorg-x11, or a MacOS machine running Apple/X11.

The connection is generally forwarded by running the following command on a client machine:

 {{{
ssh USER@MACHINE -X
}}}

  * ''MACHINE'' is the ip address or hostname of the machine that you are ssh'ing into

  * ''USER'' is the username normally used for configuring things on this machine.

Once connected to the remote machine, apps can be launched as though they are being run locally.

== This guide ==
Note: This guide isn't all inclusive, but should help most people get through the initial mythtv-setup process.  If you are looking for more details about a particular section, you will want to see the following areas:
[[http://www.mythtv.org/docs/mythtv-HOWTO-9.html#ss9.1|The official mythtv documentation ]]

[[http://www.mythtv.org/wiki/index.php/Main_Page|The official mythtv wiki ]]

[[http://www.gossamer-threads.com/lists/mythtv/users/|The official mythtv mailing list archive ]]

== Starting mythtv-setup ==
{{{mythtv-setup}}} must either be launched as a user that is in the {{{mythtv}}} group.

<<Include(MythTV/Install/mythtv-group)>>

<<Include(MythTV/Install/logout)>>
Once your are in the mythtv group and have logged out/in, you will be able to launch {{{mythtv-setup}}}.
 {{{
mythtv-setup
}}}

<<Include(MythTV/Install/mythtv-setup)>>

== Troubleshooting ==
If it shows up blue and throws errors relating to databases, check these things:
 * Are you in the mythtv group?
  * You can check who is in the mythtv group by running
   {{{
grep mythtv: /etc/group
}}}
  * If you aren't in the mythtv group, add yourself to the group
   {{{
sudo usermod -a -G mythtv USERNAME
}}}
   Where USERNAME is the name of the user being added.
  * After adding yourself to the group, remove ~/.mythtv and then '''log out/in'''.
   {{{
rm ~/.mythtv -rf
}}}
 * If you are already in the group, try to remove ~/.mythtv and then try again.
  {{{
rm ~/.mythtv -rf
}}}
 * If you still have troubles connecting to the database, you can use these commands to reset the password:
  {{{
mysql -u root mysql
}}}
  {{{
mysqlcheck -r -u mythtv -pmythtv mythconverg
}}}
   {{{
UPDATE user SET Password=PASSWORD('mythtv') WHERE user='mythtv';
}}}
   {{{
FLUSH PRIVILEGES;
}}}
   {{{
quit
}}}

Another common problem is that the mysql database cannot be found. The most probable cause is that you entered the wrong mysql root password when you installing {{{mythtv-database}}}. Mythtv-database needs the mysql root password in order to create the table needed for mythtv. The solution is to reinstall {{{mythtv-database}}} from scratch making sure before that you know the right mysql root password. One way of doing this is to actually reset the password to whatever you want by using
 {{{
sudo mysqladmin password NEWPASSWORD
}}}

When you install mythtv-database, it wiĺl prompt you for the mysql root password which is at this point NEWPASSWORD above if you reset the mysql root password.

To reinstall mythtv-database
 {{{
sudo apt-get remove --purge mythtv-database
sudo apt-get install mythtv-database
}}}