# Overseerr

![Screenshot from 2023-03-30 04-04-17.png](https://bookstack.timshome.net/uploads/images/gallery/2023-03/scaled-1680-/hdw9NL5eBqhmKFoD-screenshot-from-2023-03-30-04-04-17.png)

**Overseerr** is a free and open source software application for managing requests for your media library. It integrates with your existing services, such as **[Sonarr](https://bookstack.timshome.net/books/media-servers/page/sonarr)**, **[Radarr](https://bookstack.timshome.net/books/media-servers/page/radarr)**, and **[Plex.](https://bookstack.timshome.net/books/media-servers/page/plex)**

It provides your users with a way to make requests for your media server and automatically (or with your approval) sends the request to Sonarr or Radarr.

**![preview.jpg](https://bookstack.timshome.net/uploads/images/gallery/2023-03/scaled-1680-/drBEToFIZCTomNCj-preview.jpg)**

---

#### Installation

You can install Overseerr on various platforms. I recommend the docker container for installation. If you need another installation method they can be found here:

[**Overseer Installations**](https://docs.overseerr.dev/getting-started/installation)

##### Docker Compose

```yaml
---
version: '3'

services:
  overseerr:
    image: sctx/overseerr:latest
    container_name: overseerr
    environment:
      - LOG_LEVEL=debug
      - TZ=Asia/Tokyo
      - PORT=5055 #optional
    ports:
      - 5055:5055
    volumes:
      - /path/to/appdata/config:/app/config
    restart: unless-stopped
```

<div class="css-175oi2r" data-slate-fragment="JTdCJTIyb2JqZWN0JTIyJTNBJTIyZG9jdW1lbnQlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTJDJTIybm9kZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJibG9jayUyMiUyQyUyMnR5cGUlMjIlM0ElMjJwYXJhZ3JhcGglMjIlMkMlMjJpc1ZvaWQlMjIlM0FmYWxzZSUyQyUyMmRhdGElMjIlM0ElN0IlN0QlMkMlMjJub2RlcyUyMiUzQSU1QiU3QiUyMm9iamVjdCUyMiUzQSUyMnRleHQlMjIlMkMlMjJsZWF2ZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJsZWFmJTIyJTJDJTIydGV4dCUyMiUzQSUyMiUyMiUyQyUyMm1hcmtzJTIyJTNBJTVCJTVEJTJDJTIyc2VsZWN0aW9ucyUyMiUzQSU1QiU1RCU3RCU1RCUyQyUyMmtleSUyMiUzQSUyMmI1MmVhNDQwNWRlYTQwNjdiYTQ4ZDY1YTJiZDg5ZGVkJTIyJTdEJTVEJTJDJTIya2V5JTIyJTNBJTIyNTU1N2Y5ZTBhNDFhNDI5NGEwYzVhZDE5YzQyZDI1M2IlMjIlN0QlNUQlMkMlMjJrZXklMjIlM0ElMjI0MjE3Zjg0MTQ3YWE0YzZjYmU5ZTEyMGVkZDBmZmE2ZiUyMiU3RA==" id="bkmrk-be-sure-to-replace%C2%A0%2F"><div class="css-175oi2r"><div class="r-1oszu61 r-1xc7w19 r-1phboty r-1yadl64 r-deolkf r-6koalj r-1mlwlqe r-eqz5dr r-1q142lx r-crgep1 r-ifefl9 r-bcqeeo r-t60dpp r-bnwqim r-417010 r-1yzf0co r-95jzfe r-iphfwy" data-key="02ca30c4fcf248f883fdba7ef425023f"><div class="r-1oszu61 r-1xc7w19 r-1phboty r-1yadl64 r-deolkf r-6koalj r-eqz5dr r-crgep1 r-ifefl9 r-bcqeeo r-t60dpp r-bnwqim r-417010 r-1ro0kt6 r-16y2uox r-1wbh5a2" data-block-content="02ca30c4fcf248f883fdba7ef425023f">  
</div></div></div></div><p class="callout warning">Be sure to replace **/path/to/appdata/config** in the examples with a valid host directory path. If this volume mount is not configured correctly, your Overseerr settings/data will not be persisted when the container is recreated (e.g., when updating the image or rebooting your machine).</p>

<p class="callout warning"><span data-key="3f836f70fa90402aac7a1a09531af797" data-slate-fragment="JTdCJTIyb2JqZWN0JTIyJTNBJTIyZG9jdW1lbnQlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTJDJTIybm9kZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJibG9jayUyMiUyQyUyMnR5cGUlMjIlM0ElMjJwYXJhZ3JhcGglMjIlMkMlMjJpc1ZvaWQlMjIlM0FmYWxzZSUyQyUyMmRhdGElMjIlM0ElN0IlN0QlMkMlMjJub2RlcyUyMiUzQSU1QiU3QiUyMm9iamVjdCUyMiUzQSUyMnRleHQlMjIlMkMlMjJsZWF2ZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJsZWFmJTIyJTJDJTIydGV4dCUyMiUzQSUyMiUyMiUyQyUyMm1hcmtzJTIyJTNBJTVCJTVEJTJDJTIyc2VsZWN0aW9ucyUyMiUzQSU1QiU1RCU3RCU1RCUyQyUyMmtleSUyMiUzQSUyMjI3MmFiY2YzZjE3MTRhYzZiZTViMWVmZTBkNDE2NzQwJTIyJTdEJTVEJTJDJTIya2V5JTIyJTNBJTIyMzEzNTRjNmE4ODk5NDIzNzk0ZjYzZmMzMTE5ZmI1MWUlMjIlN0QlNUQlMkMlMjJrZXklMjIlM0ElMjIzNjg0MTg0MTJmNzA0ZGNlYjBiMTJmYjMyY2M4MWRkMSUyMiU3RA=="><span data-offset-key="3f836f70fa90402aac7a1a09531af797:0">The </span>`TZ`<span data-offset-key="3f836f70fa90402aac7a1a09531af797:2"> environment variable value should also be set to the [**TZ database name**](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) of your timezone!  
</span></span></p>

##### CLI

```python
docker run -d \
  --name overseerr \
  -e LOG_LEVEL=debug \
  -e TZ=Asia/Tokyo \
  -e PORT=5055 `#optional` \
  -p 5055:5055 \
  -v /path/to/appdata/config:/app/config \
  --restart unless-stopped \
  sctx/overseerr
```

<span data-offset-key="8ba81b764adf4b1594d5fe51e1ccb462:0">To run the container as a specific user/group, you may optionally add </span>`--user=[ user | user:group | uid | uid:gid | user:gid | uid:group ]`<span data-offset-key="8ba81b764adf4b1594d5fe51e1ccb462:2" data-slate-fragment="JTdCJTIyb2JqZWN0JTIyJTNBJTIyZG9jdW1lbnQlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTJDJTIybm9kZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJibG9jayUyMiUyQyUyMnR5cGUlMjIlM0ElMjJwYXJhZ3JhcGglMjIlMkMlMjJpc1ZvaWQlMjIlM0FmYWxzZSUyQyUyMmRhdGElMjIlM0ElN0IlN0QlMkMlMjJub2RlcyUyMiUzQSU1QiU3QiUyMm9iamVjdCUyMiUzQSUyMnRleHQlMjIlMkMlMjJsZWF2ZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJsZWFmJTIyJTJDJTIydGV4dCUyMiUzQSUyMlRvJTIwcnVuJTIwdGhlJTIwY29udGFpbmVyJTIwYXMlMjBhJTIwc3BlY2lmaWMlMjB1c2VyJTJGZ3JvdXAlMkMlMjB5b3UlMjBtYXklMjBvcHRpb25hbGx5JTIwYWRkJTIwJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlNUQlMkMlMjJzZWxlY3Rpb25zJTIyJTNBJTVCJTVEJTdEJTJDJTdCJTIyb2JqZWN0JTIyJTNBJTIybGVhZiUyMiUyQyUyMnRleHQlMjIlM0ElMjItLXVzZXIlM0QlNUIlMjB1c2VyJTIwJTdDJTIwdXNlciUzQWdyb3VwJTIwJTdDJTIwdWlkJTIwJTdDJTIwdWlkJTNBZ2lkJTIwJTdDJTIwdXNlciUzQWdpZCUyMCU3QyUyMHVpZCUzQWdyb3VwJTIwJTVEJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJtYXJrJTIyJTJDJTIydHlwZSUyMiUzQSUyMmNvZGUlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTdEJTVEJTJDJTIyc2VsZWN0aW9ucyUyMiUzQSU1QiU1RCU3RCUyQyU3QiUyMm9iamVjdCUyMiUzQSUyMmxlYWYlMjIlMkMlMjJ0ZXh0JTIyJTNBJTIyJTIwdG8lMjB0aGUlMjBhYm92ZSUyMGNvbW1hbmQuJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlNUQlMkMlMjJzZWxlY3Rpb25zJTIyJTNBJTVCJTVEJTdEJTVEJTJDJTIya2V5JTIyJTNBJTIyNWMwZDE3MjMyNWRmNGQ0YWIzOGJiZTE2YTBiMjFiNTclMjIlN0QlNUQlMkMlMjJrZXklMjIlM0ElMjI1ZDc5NzFkZTY1ZjU0NGEzYWNmZWU4MjM5ZjIzNWRjYyUyMiU3RCU1RCUyQyUyMmtleSUyMiUzQSUyMmQzZTMzMDAyOTEzMzRkN2U4YjVlZjczMmZkOWQ1ZjRlJTIyJTdE"> to the above command.</span>

##### <span data-offset-key="8ba81b764adf4b1594d5fe51e1ccb462:2" data-slate-fragment="JTdCJTIyb2JqZWN0JTIyJTNBJTIyZG9jdW1lbnQlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTJDJTIybm9kZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJibG9jayUyMiUyQyUyMnR5cGUlMjIlM0ElMjJwYXJhZ3JhcGglMjIlMkMlMjJpc1ZvaWQlMjIlM0FmYWxzZSUyQyUyMmRhdGElMjIlM0ElN0IlN0QlMkMlMjJub2RlcyUyMiUzQSU1QiU3QiUyMm9iamVjdCUyMiUzQSUyMnRleHQlMjIlMkMlMjJsZWF2ZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJsZWFmJTIyJTJDJTIydGV4dCUyMiUzQSUyMlRvJTIwcnVuJTIwdGhlJTIwY29udGFpbmVyJTIwYXMlMjBhJTIwc3BlY2lmaWMlMjB1c2VyJTJGZ3JvdXAlMkMlMjB5b3UlMjBtYXklMjBvcHRpb25hbGx5JTIwYWRkJTIwJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlNUQlMkMlMjJzZWxlY3Rpb25zJTIyJTNBJTVCJTVEJTdEJTJDJTdCJTIyb2JqZWN0JTIyJTNBJTIybGVhZiUyMiUyQyUyMnRleHQlMjIlM0ElMjItLXVzZXIlM0QlNUIlMjB1c2VyJTIwJTdDJTIwdXNlciUzQWdyb3VwJTIwJTdDJTIwdWlkJTIwJTdDJTIwdWlkJTNBZ2lkJTIwJTdDJTIwdXNlciUzQWdpZCUyMCU3QyUyMHVpZCUzQWdyb3VwJTIwJTVEJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJtYXJrJTIyJTJDJTIydHlwZSUyMiUzQSUyMmNvZGUlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTdEJTVEJTJDJTIyc2VsZWN0aW9ucyUyMiUzQSU1QiU1RCU3RCUyQyU3QiUyMm9iamVjdCUyMiUzQSUyMmxlYWYlMjIlMkMlMjJ0ZXh0JTIyJTNBJTIyJTIwdG8lMjB0aGUlMjBhYm92ZSUyMGNvbW1hbmQuJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlNUQlMkMlMjJzZWxlY3Rpb25zJTIyJTNBJTVCJTVEJTdEJTVEJTJDJTIya2V5JTIyJTNBJTIyNWMwZDE3MjMyNWRmNGQ0YWIzOGJiZTE2YTBiMjFiNTclMjIlN0QlNUQlMkMlMjJrZXklMjIlM0ElMjI1ZDc5NzFkZTY1ZjU0NGEzYWNmZWU4MjM5ZjIzNWRjYyUyMiU3RCU1RCUyQyUyMmtleSUyMiUzQSUyMmQzZTMzMDAyOTEzMzRkN2U4YjVlZjczMmZkOWQ1ZjRlJTIyJTdE">Updating</span>

<span data-offset-key="8ba81b764adf4b1594d5fe51e1ccb462:2" data-slate-fragment="JTdCJTIyb2JqZWN0JTIyJTNBJTIyZG9jdW1lbnQlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTJDJTIybm9kZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJibG9jayUyMiUyQyUyMnR5cGUlMjIlM0ElMjJwYXJhZ3JhcGglMjIlMkMlMjJpc1ZvaWQlMjIlM0FmYWxzZSUyQyUyMmRhdGElMjIlM0ElN0IlN0QlMkMlMjJub2RlcyUyMiUzQSU1QiU3QiUyMm9iamVjdCUyMiUzQSUyMnRleHQlMjIlMkMlMjJsZWF2ZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJsZWFmJTIyJTJDJTIydGV4dCUyMiUzQSUyMlRvJTIwcnVuJTIwdGhlJTIwY29udGFpbmVyJTIwYXMlMjBhJTIwc3BlY2lmaWMlMjB1c2VyJTJGZ3JvdXAlMkMlMjB5b3UlMjBtYXklMjBvcHRpb25hbGx5JTIwYWRkJTIwJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlNUQlMkMlMjJzZWxlY3Rpb25zJTIyJTNBJTVCJTVEJTdEJTJDJTdCJTIyb2JqZWN0JTIyJTNBJTIybGVhZiUyMiUyQyUyMnRleHQlMjIlM0ElMjItLXVzZXIlM0QlNUIlMjB1c2VyJTIwJTdDJTIwdXNlciUzQWdyb3VwJTIwJTdDJTIwdWlkJTIwJTdDJTIwdWlkJTNBZ2lkJTIwJTdDJTIwdXNlciUzQWdpZCUyMCU3QyUyMHVpZCUzQWdyb3VwJTIwJTVEJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJtYXJrJTIyJTJDJTIydHlwZSUyMiUzQSUyMmNvZGUlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTdEJTVEJTJDJTIyc2VsZWN0aW9ucyUyMiUzQSU1QiU1RCU3RCUyQyU3QiUyMm9iamVjdCUyMiUzQSUyMmxlYWYlMjIlMkMlMjJ0ZXh0JTIyJTNBJTIyJTIwdG8lMjB0aGUlMjBhYm92ZSUyMGNvbW1hbmQuJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlNUQlMkMlMjJzZWxlY3Rpb25zJTIyJTNBJTVCJTVEJTdEJTVEJTJDJTIya2V5JTIyJTNBJTIyNWMwZDE3MjMyNWRmNGQ0YWIzOGJiZTE2YTBiMjFiNTclMjIlN0QlNUQlMkMlMjJrZXklMjIlM0ElMjI1ZDc5NzFkZTY1ZjU0NGEzYWNmZWU4MjM5ZjIzNWRjYyUyMiU3RCU1RCUyQyUyMmtleSUyMiUzQSUyMmQzZTMzMDAyOTEzMzRkN2U4YjVlZjczMmZkOWQ1ZjRlJTIyJTdE"><span data-slate-fragment="JTdCJTIyb2JqZWN0JTIyJTNBJTIyZG9jdW1lbnQlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTJDJTIybm9kZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJibG9jayUyMiUyQyUyMnR5cGUlMjIlM0ElMjJwYXJhZ3JhcGglMjIlMkMlMjJpc1ZvaWQlMjIlM0FmYWxzZSUyQyUyMmRhdGElMjIlM0ElN0IlN0QlMkMlMjJub2RlcyUyMiUzQSU1QiU3QiUyMm9iamVjdCUyMiUzQSUyMnRleHQlMjIlMkMlMjJsZWF2ZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJsZWFmJTIyJTJDJTIydGV4dCUyMiUzQSUyMlN0b3AlMjBhbmQlMjByZW1vdmUlMjB0aGUlMjBleGlzdGluZyUyMGNvbnRhaW5lciUzQSUyMiUyQyUyMm1hcmtzJTIyJTNBJTVCJTVEJTJDJTIyc2VsZWN0aW9ucyUyMiUzQSU1QiU1RCU3RCU1RCUyQyUyMmtleSUyMiUzQSUyMjMwZGUxMjMxNzkyZDQwMThiYWI5NmM1NjJjN2Y3MTkwJTIyJTdEJTVEJTJDJTIya2V5JTIyJTNBJTIyMWQ5ZDI4YjA0NzAwNGNlZThiZTNjZjQxMWI5OWJhZmQlMjIlN0QlNUQlMkMlMjJrZXklMjIlM0ElMjI0YjFkYmMyZDZiNmU0Y2JmOGZmMTk4MTRiYzkwNDZlOCUyMiU3RA==" style="white-space: pre;">Stop and remove the existing container:</span></span>

```shell
docker stop overseerr && docker rm overseerr
```

<span data-offset-key="8ba81b764adf4b1594d5fe51e1ccb462:2" data-slate-fragment="JTdCJTIyb2JqZWN0JTIyJTNBJTIyZG9jdW1lbnQlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTJDJTIybm9kZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJibG9jayUyMiUyQyUyMnR5cGUlMjIlM0ElMjJwYXJhZ3JhcGglMjIlMkMlMjJpc1ZvaWQlMjIlM0FmYWxzZSUyQyUyMmRhdGElMjIlM0ElN0IlN0QlMkMlMjJub2RlcyUyMiUzQSU1QiU3QiUyMm9iamVjdCUyMiUzQSUyMnRleHQlMjIlMkMlMjJsZWF2ZXMlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJsZWFmJTIyJTJDJTIydGV4dCUyMiUzQSUyMlRvJTIwcnVuJTIwdGhlJTIwY29udGFpbmVyJTIwYXMlMjBhJTIwc3BlY2lmaWMlMjB1c2VyJTJGZ3JvdXAlMkMlMjB5b3UlMjBtYXklMjBvcHRpb25hbGx5JTIwYWRkJTIwJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlNUQlMkMlMjJzZWxlY3Rpb25zJTIyJTNBJTVCJTVEJTdEJTJDJTdCJTIyb2JqZWN0JTIyJTNBJTIybGVhZiUyMiUyQyUyMnRleHQlMjIlM0ElMjItLXVzZXIlM0QlNUIlMjB1c2VyJTIwJTdDJTIwdXNlciUzQWdyb3VwJTIwJTdDJTIwdWlkJTIwJTdDJTIwdWlkJTNBZ2lkJTIwJTdDJTIwdXNlciUzQWdpZCUyMCU3QyUyMHVpZCUzQWdyb3VwJTIwJTVEJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlN0IlMjJvYmplY3QlMjIlM0ElMjJtYXJrJTIyJTJDJTIydHlwZSUyMiUzQSUyMmNvZGUlMjIlMkMlMjJkYXRhJTIyJTNBJTdCJTdEJTdEJTVEJTJDJTIyc2VsZWN0aW9ucyUyMiUzQSU1QiU1RCU3RCUyQyU3QiUyMm9iamVjdCUyMiUzQSUyMmxlYWYlMjIlMkMlMjJ0ZXh0JTIyJTNBJTIyJTIwdG8lMjB0aGUlMjBhYm92ZSUyMGNvbW1hbmQuJTIyJTJDJTIybWFya3MlMjIlM0ElNUIlNUQlMkMlMjJzZWxlY3Rpb25zJTIyJTNBJTVCJTVEJTdEJTVEJTJDJTIya2V5JTIyJTNBJTIyNWMwZDE3MjMyNWRmNGQ0YWIzOGJiZTE2YTBiMjFiNTclMjIlN0QlNUQlMkMlMjJrZXklMjIlM0ElMjI1ZDc5NzFkZTY1ZjU0NGEzYWNmZWU4MjM5ZjIzNWRjYyUyMiU3RCU1RCUyQyUyMmtleSUyMiUzQSUyMmQzZTMzMDAyOTEzMzRkN2U4YjVlZjczMmZkOWQ1ZjRlJTIyJTdE">Pull the latest image:</span>

```shell
docker pull sctx/overseerr
```

Finally, run the container with the same parameters originally used to create the container:

```shell
docker run -d ...
```

<p class="callout info">You may alternatively use a third-party updating mechanism, such as [**Watchtower**](https://bookstack.timshome.net/books/home-server-applications/page/watchtower) or **[Ouroboros](https://github.com/pyouroboros/ouroboros)** to keep Overseerr up-to-date automatically.</p>