mirror of
https://github.com/Tautulli/Tautulli.git
synced 2025-03-12 04:35:40 -07:00
Update for Python 3 support and some minor cleanups
Landon Abney
parent
d90865488f
commit
fa2c72e060
@ -2,7 +2,6 @@
|
||||
|
||||
## General
|
||||
|
||||
* [I have some weird Python errors!](#general-q1)
|
||||
* [I am receiving some weird datatable warnings.](#general-q2)
|
||||
* [I forgot my username and/or password!](#general-q3)
|
||||
* [I can't reach the web interface!](#general-q4)
|
||||
@ -16,7 +15,6 @@
|
||||
* [Help! I accidentally deleted a user/library! How can I add it back?](#general-q12)
|
||||
* [Can I import my history from PlexWatch/Plexivity?](#general-q13)
|
||||
* [Where can I find my Tautulli logs?](#general-q14)
|
||||
* [When trying to install the GeoLite2 database, I get the error "Uncaught ReferenceError: confirmAjaxCall is not defined."](#general-q15)
|
||||
* [Tautulli says "There was an error communicating with your Plex Server", and the logs say "Status code 401".](#general-q16)
|
||||
* [I can't connect to my Plex server with "Use SSL" checked.](#general-q17)
|
||||
* [My Tautulli database got corrupted: "DatabaseError: database disk image is malformed."](#general-q18)
|
||||
@ -103,9 +101,6 @@
|
||||
|
||||
### General
|
||||
|
||||
#### <a id="general-q1">Q:</a> I have some weird Python errors!
|
||||
**A:** Please make sure you have the latest version of Python 2.7.x installed. Python 3.x is not supported by Tautulli.
|
||||
|
||||
#### <a id="general-q2">Q:</a> I am receiving some weird datatable warnings.
|
||||
**A:** Most datatable warnings can be solved by doing a force refresh in your browser (<kbd>CTRL</kbd>+<kbd>F5</kbd> or <kbd>OPTION</kbd>+<kbd>Reload</kbd> on Mac/Safari). If that doesn't work, try clearing your browser's cache.
|
||||
|
||||
@ -147,7 +142,7 @@ sudo chown -R tautulli:tautulli /path/to/Tautulli
|
||||
##### ZIP install
|
||||
|
||||
If you instead installed Tautulli by simply downloading the current release archive, the steps are simpler:
|
||||
1. Download the [current release](https://github.com/Tautulli/Tautulli/releases)
|
||||
1. Download the [current release](https://github.com/Tautulli/Tautulli/zipball/master)
|
||||
2. Shut down Tautulli
|
||||
3. Extract the current release to the same location where you previously extracted it
|
||||
* Note: You should be _replacing_ the existing files, if you are prompted about this please select to replace the files!
|
||||
@ -182,7 +177,7 @@ The most secure method, but also the most inconvenient, is to set up a VPN tunne
|
||||
#### <a id="general-q10">Q:</a> Why does Tautulli not work with my reverse proxy setup?
|
||||
**A:** Tautulli uses CherryPy as it's web server, and it includes support for reverse proxies. You must ensure that your proxy web server (e.g. NGINX or Apache) is sending the standard `X-` headers to CherryPy. For **NGINX**, the configuration would look like this:
|
||||
|
||||
```
|
||||
```nginx
|
||||
# Standard proxying headers
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
@ -192,14 +187,14 @@ proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
|
||||
If you have SSL enabled on your webserver (e.g. `Internet --> https://nginx --> http://tautulli`), make sure HTTP Proxy is checked under Settings > <kbd>Show Advanced</kbd> button > Web Interface. Then ensure that your proxy web server is also including these two SSL specific `X-` headers:
|
||||
|
||||
```
|
||||
```nginx
|
||||
# SSL proxying headers
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
proxy_set_header X-Forwarded-Ssl on;
|
||||
```
|
||||
|
||||
As an alternative, the following configuration will automatically work for both HTTP and HTTPS.
|
||||
```
|
||||
```nginx
|
||||
location /tautulli/ {
|
||||
proxy_pass http://127.0.0.1:8181;
|
||||
proxy_set_header Host $host;
|
||||
@ -220,9 +215,9 @@ location /tautulli/ {
|
||||
Don't forget to clear your web browser's cache *every* time you update your web server configuration.
|
||||
|
||||
#### <a id="general-q11">Q:</a> I need to move/reinstall Tautulli. Can I keep my history and statistics?
|
||||
**A:** Yes, all you need to do is copy your `tautulli.db` database file somewhere safe (make sure Tautulli is shut down when doing this). Then after reinstalling, place the file back inside the Tautulli folder before starting up Tautulli again. This will work between any OS.
|
||||
**A:** Yes, all you need to do is copy your `tautulli.db` database file somewhere safe (make sure Tautulli is shut down when doing this). Then after reinstalling, open the settings and import the old `tautulli.db`. This will work between any OS.
|
||||
|
||||
Although not necessary to keep the history and statistics, you can also copy the `config.ini` file, although you will need to edit any file and folder paths within the configuration to point to their new location.
|
||||
Although not necessary to keep the history and statistics, you can copy the `config.ini` file while Tautulli is shut down. You will need to edit any file and folder paths within the configuration to point to their new location **before** starting Tautulli back up.
|
||||
|
||||
**WARNING**: If you are re-installing Plex as well please follow [their guide to Move an Install to Another System](https://support.plex.tv/articles/201370363-move-an-install-to-another-system/). If you are starting from scratch again with Plex, or forgot to do this step, then you **MUST** run the script from [this FAQ entry](#move-media), or your Tautulli database will link to the wrong items!
|
||||
|
||||
@ -277,9 +272,6 @@ http://localhost:8181/undelete_library?section_name=Anime
|
||||
#### <a id="general-q14">Q:</a> Where can I find my Tautulli logs?
|
||||
**A:** You can view the Tautulli logs from the web interface by clicking on "View Logs" in the settings menu. Clicking on the "Download logs" button on this page will allow you to save a copy of the log file. If Tautulli is unable to start, then the log file is located at `logs/tautulli.log` in the folder where you have Tautulli installed. When reporting an issue, please provide a link to this log file by pasting it on [Gist](http://gist.github.com), *do not* upload the file as an attachment.
|
||||
|
||||
#### <a id="general-q15">Q:</a> When trying to install the GeoLite2 database, I get the error "Uncaught ReferenceError: confirmAjaxCall is not defined."?
|
||||
**A:** You need to clear your browser cache or force refresh using <kbd>CTRL</kbd>+<kbd>F5</kbd> (<kbd>OPTION</kbd>+<kbd>Reload</kbd> on Mac/Safari).
|
||||
|
||||
#### <a id="general-q16">Q:</a> Tautulli says "There was an error communicating with your Plex Server", and the logs say "Status code 401".
|
||||
**A:** Go into the Tautulli Settings > Plex Media Server and fetch a new Plex.tv token.
|
||||
|
||||
@ -349,7 +341,7 @@ If you would like to opt-out of data collection, you can set `system_analytics =
|
||||
|
||||
If you are on macOS, first try updating to at least 10.13.4.
|
||||
|
||||
The solution to most of these problems is to simply ensure you are on the latest v2 release of [Python](https://www.python.org/downloads/release/python-2717/). If that doesn't work for you, the next thing to try is installing the latest version of [`pyOpenSSL`](https://pypi.python.org/pypi/pyOpenSSL), instructions for Windows can be found [here](https://github.com/Tautulli/Tautulli-Wiki/wiki/Frequently-Asked-Questions#windows-q1). That should allow Tautulli to talk to GitHub again and check for updates.
|
||||
The solution to most of these problems is to simply ensure you are on the latest v3 release of [Python](https://www.python.org/downloads/). If that doesn't work for you, the next thing to try is installing the latest version of [`pyOpenSSL`](https://pypi.python.org/pypi/pyOpenSSL), instructions for Windows can be found [here](https://github.com/Tautulli/Tautulli-Wiki/wiki/Frequently-Asked-Questions#windows-q1). That should allow Tautulli to talk to GitHub again and check for updates.
|
||||
|
||||
If you are on a `git` based installation and `git` itself runs into problems when trying to download the updates, you should make sure you are on the current version of `git` for your platform.
|
||||
|
||||
@ -588,7 +580,7 @@ pip install pyopenssl
|
||||
If that doesn't work:
|
||||
|
||||
1. Download the latest version of pyOpenSSL [here](https://pypi.python.org/pypi/pyOpenSSL#downloads) (the source `.tar.gz` file) and save it to `C:\`.
|
||||
2. Run `C:\Python27\Scripts\pip.exe install C:\pyOpenSSL-17.5.0.tar.gz`
|
||||
2. Run `python -m pip install C:\pyOpenSSL-17.5.0.tar.gz`
|
||||
|
||||
If you have installed Python into a different directory or saved pyOpenSSL to somewhere else, you have to modify the above command in step 2 accordingly.
|
||||
|
||||
@ -611,8 +603,8 @@ _Note: If you are seeing this and aren't running Windows, it's likely you are hi
|
||||
#### <a id="windows-q6">Q:</a> The command prompt just flashes open then closes immediately when starting Tautulli.
|
||||
**A:** Start Tautulli manually from the command prompt to view the error. Open the Windows command prompt then running the following command. Fill in `C:\path\to\tautulli` to match the path where Tautulli is installed.
|
||||
|
||||
```
|
||||
C:\Python27\python.exe "C:\path\to\tautulli\Tautulli.py"
|
||||
```batch
|
||||
& 'C:\Program Files\Python38\python.exe' "C:\path\to\tautulli\Tautulli.py"
|
||||
```
|
||||
|
||||
Then refer to [this FAQ](#general-q1) above.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user