MySQL/Setting up MySQL: Difference between revisions
< MySQL
Jump to navigation
Jump to search
m (→Ubuntu Linux) |
|||
(22 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
{{:MySQL/Contents}} | {{:MySQL/Contents}} | ||
{{mininav| [[MySQL]] }} | {{mininav| [[MySQL]] }} | ||
You'll need to choose which of your computers, Kodi devices, or | You'll need to choose which of your computers, Kodi devices, or NAS will be the MySQL server. The server needs to be on 24/7 or have wake-on-lan (preferably the former), and needs to have a local static IP. You will probably want the Kodi device that is hosting most or all of your videos and music to also be the MySQL server, but this is not required. | ||
{{-}} | {{-}} | ||
{{redv|'''Please Note:'''| | {{redv|'''Please Note:'''| Do not manually create the MySQL/MariaDB databases on your database server. Set up the MySQL/MariaDB server, and Kodi will create the specific databases for you.}} | ||
{{redv|'''Also:'''| Some versions of MySQL set their passwords to expire by default, '''even the root password'''! If the password expires, Kodi cannot access the database and the TV Series and Movies libraries will disappear.<br /> | {{redv|'''Also:'''| Some versions of MySQL set their passwords to expire by default, '''even the root password'''! If the password expires, Kodi cannot access the database and the TV Series and Movies libraries will disappear.<br /> | ||
To avoid this and/or fix it after it happens, make sure the account's password does not expire. (See: https://dev.mysql.com/doc/refman/5.7/en/password- | To avoid this and/or fix it after it happens, make sure the account's password does not expire. (See: https://dev.mysql.com/doc/refman/5.7/en/password-management.html )}} | ||
MySQL can be installed on just about every major OS: | MySQL/MariaDB can be installed on just about every major OS and NAS: | ||
{{redv|'''Important:'''| Please use only supported versions of the MySQL or MariaDB server. As of January 2019, this is MySQL in at least version 5.7 or MariaDB in at least version 5.5, but version 10.3+ is recommended.}} | |||
=Ubuntu Linux= | =Ubuntu Linux= | ||
'''Ubuntu Linux:''' | '''Ubuntu Linux:''' | ||
#<code>$sudo apt-get install mysql-server</code> ''(see also: https://help.ubuntu.com/ | #<code>$sudo apt-get install mysql-server</code> ''(see also: https://help.ubuntu.com/18.04/serverguide/mysql.html )'' | ||
#Create a password when asked | #Create a password when asked | ||
#To configure MySQL to listen for connections from network hosts, edit ''/etc/mysql/mysql.conf.d/mysqld.cnf'' and change the bind-address directive to the server's IP address: | #To configure MySQL to listen for connections from network hosts, edit ''/etc/mysql/mysql.conf.d/mysqld.cnf'' and change the bind-address directive to the server's IP address: | ||
Line 19: | Line 21: | ||
#*Note: Replace 192.168.0.5 with the appropriate address. | #*Note: Replace 192.168.0.5 with the appropriate address. | ||
#*Note: To allow both local and remote access (i.e. from both the MySQL host to itself and also from other clients), either comment out the bind-address using a hash (#) to disable it, or use <code>bind-address = 0.0.0.0</code> to open it completely. | #*Note: To allow both local and remote access (i.e. from both the MySQL host to itself and also from other clients), either comment out the bind-address using a hash (#) to disable it, or use <code>bind-address = 0.0.0.0</code> to open it completely. | ||
# | #When using MySQL8 or higher (Ubuntu 20.04 or later), add the following line at the end of ''/etc/mysql/mysql.conf.d/mysqld.cnf'': | ||
##<code>default_authentication_plugin=mysql_native_password</code> | |||
##*Note: When using MariaDB this is the default, so you don't need to set it separately | |||
#Restart your MySQL server. <code>sudo service mysql restart</code> | |||
#Get into the MySQL command line utility: <code>mysql -u root -p</code> | #Get into the MySQL command line utility: <code>mysql -u root -p</code> | ||
#Enter the following commands: | #Enter the following commands: | ||
##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ||
##*Note: When using MySQL8 or higher, there are additional password requirements and new authentication methods. Using the following command should avoid errors. Type in: <code>CREATE USER 'kodi' IDENTIFIED WITH mysql_native_password BY 'kodi123#';</code> and press return | |||
##*Note: If the above command throws the error <code>ERROR 1064 (42000): You have an error in your SQL syntax;</code> (could happen if using MariaDB 10.5) try this one: <code>CREATE USER 'kodi' IDENTIFIED VIA mysql_native_password USING PASSWORD('kodi123#');</code> and press return | |||
##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | ##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | ||
##Type in: <code>flush privileges;</code> and press return | ##Type in: <code>flush privileges;</code> and press return | ||
#Close out the command line tool with <code>\q</code> | #Close out the command line tool with <code>\q</code> | ||
=Debian Linux= | |||
'''Debian Linux:''' | |||
#Login as root with <code>$ su -</code> | |||
#<code># apt-get install mariadb-server</code> | |||
#To configure MySQL/MariaDB to listen for connections from network hosts, edit ''/etc/mysql/mariadb.conf.d/50-server.cnf'' and change the bind-address directive to the server's IP address: | |||
##from: <code>bind-address = 127.0.0.1</code> | |||
##to: <code>bind-address = 192.168.0.5</code> | |||
#*Note: Replace 192.168.0.5 with the appropriate address. | |||
#*Note: To allow both local and remote access (i.e. from both the MySQL/MariaDB host to itself and also from other clients), either comment out the bind-address using a hash (#) to disable it, or use <code>bind-address = 0.0.0.0</code> to open it completely. | |||
#Restart your MySQL/MariaDB server. <code># systemctl restart mariadb</code> | |||
#Get into the MySQL command line utility: <code># mysql</code> | |||
#Enter the following commands: | |||
##Type in: <code>CREATE USER 'kodi' IDENTIFIED VIA mysql_native_password USING PASSWORD('kodi123#');</code> and press return | |||
##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | |||
##Type in: <code>flush privileges;</code> and press return | |||
#Close out the command line tool with <code>exit</code> or <code>\q</code> | |||
#Logout as root with <code># exit</code> | |||
=Arch Linux= | =Arch Linux= | ||
Line 52: | Line 77: | ||
#Get into the MySQL command line utility: <code>$mysql -u root -p</code> | #Get into the MySQL command line utility: <code>$mysql -u root -p</code> | ||
#*Enter your MySQL root password as set above, or just press enter if you didn't set one to log in with a blank password | #*Enter your MySQL root password as set above, or just press enter if you didn't set one to log in with a blank password | ||
#Enter the following commands: | |||
##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | |||
##Type in: <code>GRANT ALL ON *.* TO 'kodi';</code> and press return | |||
##Type in: <code>flush privileges;</code> and press return | |||
#Close out the command line tool with <code>\q</code> | |||
=RaspberryPi Raspbian= | |||
'''RaspberryPi Raspbian:''' | |||
#<code>$sudo apt-get update && sudo apt-get dist-upgrade</code> to ensure that you have the very latest iteration of Raspbian. ''(September 2017 as of writing this)'' | |||
#<code>$sudo apt-get install mysql-server</code> to install ''MYSQL Server''. | |||
#To configure MySQL to listen for connections from network hosts, <code>$sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf</code> and change the bind-address directive to the server's IP address: | |||
##from: <code>bind-address = 127.0.0.1</code> | |||
##to: <code>bind-address = 192.168.0.5</code> | |||
#*Note: Replace 192.168.0.5 with the appropriate address. | |||
#*Note: To allow both local and remote access (i.e. from both the MySQL host to itself and also from other clients), either comment out the bind-address using a hash (#) to disable it, or use <code>bind-address = 0.0.0.0</code> to open it completely. | |||
#Restart your MySQL server: <code>sudo service mysql restart</code> | |||
#Get into the MySQL command line utility: <code>sudo mysql</code> | |||
#Enter the following commands: | #Enter the following commands: | ||
##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ##Type in: <code>CREATE USER 'kodi' IDENTIFIED BY 'kodi';</code> and press return | ||
Line 86: | Line 129: | ||
If you have chocolatey installed run '''choco install mysql''' | If you have chocolatey installed run '''choco install mysql''' | ||
:'''or''' | :'''or''' | ||
#Download a copy of MySQL server from | #Download a copy of MySQL server from https://dev.mysql.com/downloads/windows/installer/8.0.html | ||
#Select '' | #Select ''Archives'' when you want the last stable main version 5.7.36 instead of version 8.0.x. | ||
#Create a password when asked | #Create a password when asked | ||
#Select that you want the database to have network access when prompted during installation. | #Select that you want the database to have network access when prompted during installation. | ||
Line 105: | Line 148: | ||
:#For Profile, you can leave it as default (everything checked by default) and hit Next | :#For Profile, you can leave it as default (everything checked by default) and hit Next | ||
:#For Name, set it to '''''MySQL''''' or any name that you will know what it is and click Finished | :#For Name, set it to '''''MySQL''''' or any name that you will know what it is and click Finished | ||
== Setup users in MySQL for Kodi clients == | == Setup users in MySQL for Kodi clients == | ||
Line 130: | Line 164: | ||
MySQL can also be installed on some [[w:network-attached storage|network-attached storage (NAS)]] device devices. Here are some guides for various NAS devices that can have a MySQL server installed: | MySQL can also be installed on some [[w:network-attached storage|network-attached storage (NAS)]] device devices. Here are some guides for various NAS devices that can have a MySQL server installed: | ||
*Devices running Arch Linux ARM (such as the PogoPlug, Dockstar, etc) can use the [[ | *Devices running Arch Linux ARM (such as the PogoPlug, Dockstar, etc) can use the [[Setting_up_MySQL|Arch Linux instructions]] on this page. | ||
*[http://quixventure.com/2011/12/configure-a-synology-nas-as-mysql-server-for-xbmc/ Synology NAS as MySQL server for XBMC] and http://youtu.be/3PmmDtK65ks | *[https://web.archive.org/web/20160329053954/http://quixventure.com/2011/12/configure-a-synology-nas-as-mysql-server-for-xbmc/ Synology NAS as MySQL server for XBMC] and http://youtu.be/3PmmDtK65ks | ||
*http://www.robvanhamersveld.nl/2013/02/05/share-your-xbmc-12-0-library-on-a-synology-ds-or-other-nas/ Synology DS with MySQL guide based on Frodo | *http://www.robvanhamersveld.nl/2013/02/05/share-your-xbmc-12-0-library-on-a-synology-ds-or-other-nas/ Synology DS with MySQL guide based on Frodo | ||
*http://forum.kodi.tv/showthread.php?tid=172548 - unRAID | *http://forum.kodi.tv/showthread.php?tid=172548 - unRAID | ||
After setting up a database server on you NAS, you should create a Kodi user with full administrative privileges. The user should be able to log in from your Kodi devices, so make sure you give the user login access from external machines. | |||
You do not need to create a database as Kodi will create the required databases itself. | |||
{{redv|'''Warning:'''| As you are giving the Kodi user full administrative privileges and external machine access it is recommended that you review your database security. It is highly recommenced that you block internet access to your database using an appropriate firewall. }} | |||
=FreeNAS and freeBSD= | =FreeNAS and freeBSD= | ||
Line 213: | Line 252: | ||
'''Optional:''' '''If you only use the MySQL server for Kodi and that server has non-critical data on it, then this probably not necessary.''' | '''Optional:''' '''If you only use the MySQL server for Kodi and that server has non-critical data on it, then this probably not necessary.''' | ||
For a more secure MySQL installation use these 2 commands to grant permission only to databases Kodi uses. This is useful if you plan on using your MySQL server for more than just Kodi, or if you're worried about your internal network being exposed and wanting to lock things down more, etc. | For a more secure MySQL installation use these 2 commands to grant permission only to databases Kodi uses. This is useful if you plan on using your MySQL server for more than just Kodi, or if you're worried about your internal network being exposed and wanting to lock things down more, etc. | ||
'''Upto MySQL Server 5.7 Server:''' | |||
#<code>GRANT ALL ON `MyVideos%`.* TO 'kodi'@'%' IDENTIFIED BY 'kodi';</code> | |||
#<code>GRANT ALL ON `MyMusic%`.* TO 'kodi'@'%' IDENTIFIED BY 'kodi';</code> | #<code>GRANT ALL ON `MyMusic%`.* TO 'kodi'@'%' IDENTIFIED BY 'kodi';</code> | ||
#<code>GRANT ALL ON `MyVideos%`.* TO | |||
'''As per MySQL 8.0 Server and upwards:''' | |||
#<code>GRANT ALL PRIVILEGES ON `MyVideos%`.* TO `kodi`@`%`;</code> | |||
#<code>GRANT ALL PRIVILEGES ON `MyMusic%`.* TO `kodi`@`%`;</code> | |||
{{redv|'''Careful'''|The limited grants on this page don't give the kodi user permissions to create required TRIGGERs during install or upgrade. '''Kodi requires these TRIGGERs to function properly.''' <br /> | {{redv|'''Careful'''|The limited grants on this page don't give the kodi user permissions to create required TRIGGERs during install or upgrade. '''Kodi requires these TRIGGERs to function properly.''' <br /> |
Latest revision as of 11:32, 5 January 2024
Share libraries w/MySQL, guide: |
MySQL | Setting up MySQL |
You'll need to choose which of your computers, Kodi devices, or NAS will be the MySQL server. The server needs to be on 24/7 or have wake-on-lan (preferably the former), and needs to have a local static IP. You will probably want the Kodi device that is hosting most or all of your videos and music to also be the MySQL server, but this is not required.
Please Note: Do not manually create the MySQL/MariaDB databases on your database server. Set up the MySQL/MariaDB server, and Kodi will create the specific databases for you.
Also: Some versions of MySQL set their passwords to expire by default, even the root password! If the password expires, Kodi cannot access the database and the TV Series and Movies libraries will disappear.
To avoid this and/or fix it after it happens, make sure the account's password does not expire. (See: https://dev.mysql.com/doc/refman/5.7/en/password-management.html )
To avoid this and/or fix it after it happens, make sure the account's password does not expire. (See: https://dev.mysql.com/doc/refman/5.7/en/password-management.html )
MySQL/MariaDB can be installed on just about every major OS and NAS:
Important: Please use only supported versions of the MySQL or MariaDB server. As of January 2019, this is MySQL in at least version 5.7 or MariaDB in at least version 5.5, but version 10.3+ is recommended.
Next step: | Setting up Kodi |