documentation/docs/db-maintenance.md
2023-07-10 15:48:38 +02:00

1.4 KiB

Database maintenance

!!! Note

You do not need to setup a cleanup cron anymore as there is now an automatic cleaning process in Invidious.
Since this pull request: [https://github.com/iv-org/invidious/pull/3294](https://github.com/iv-org/invidious/pull/3294).
But this page is left in case you need to manually cleanup the database.

Invidious needs one PostgreSQL database which has the following tables.

  • annotations Caches annotation data if cache_annotations is enabled in config.yml
  • channel_videos Stores truncated video info, used to create user feeds
  • channels Stores UCID and author name
  • nonces Keeps track of tokens issued to prevent CSRF
  • users Stores user info, such as preferences, username, subscriptions
  • session_ids Keeps track of user sessions
  • videos Stores video cache, used to create "top" page

The table videos grows a lot and needs the most storage. You can clean it up using following commands:

$ sudo -i -u postgres
$ psql invidious -c "DELETE FROM nonces * WHERE expire < current_timestamp"
$ psql invidious -c "TRUNCATE TABLE videos"
$ exit

For regular maintenance you should add a cronjob for these commands

@weekly psql invidious -c "DELETE FROM nonces * WHERE expire < current_timestamp" > /dev/null
@weekly psql invidious -c "TRUNCATE TABLE videos" > /dev/null