Tool:Unwatchlist

Unwatchlist is a Node.js + Nuxt webserver that helps remove pages from users' watchlists.

This tool is being deployed using the Toolforge Build Service.

Deployments are not automatic. As the Wikimedia GitLab instance develops, this may change in the future. For now, the following steps are used to deploy new versions of the tool.

Unwatchlist relies on Node.js 22, which (as of 17 September 2025) isn't supported by the 22_20240105 version of the heroku-builder image on Toolforge. You will need to run toolforge build start with the --use-latest-versions/-L parameter.

1. [me@tools-sgebastion-XX] become unwatchlist
   • That's pretty obvious already.
2. [tools.unwatchlist@tools-sgebastion-XX] toolforge build start -L https://gitlab.wikimedia.org/toolforge-repos/unwatchlist
   • Trigger a build on the Toolforge Build Service. This downloads the latest version of the repository (on main) and performs all necessary build steps.
3. [tools.unwatchlist@tools-sgebastion-XX] toolforge webservice restart
   • Restart the webservice. In the event that the service.manifest got deleted or the service must be restarted from scratch, use the following command:

     [tools.unwatchlist@tools-sgebastion-XX] toolforge webservice buildservice start

4. [tools.unwatchlist@tools-sgebastion-XX] toolforge webservice logs -f
   • Verify that the tool is up and running.

For deployment issues, you can email wiki@chlod.net or use Special:EmailUser/Chlod.

This tool relies on a Redis job on its namespace. See Help:Toolforge/Redis#Redis containers for information on how to run the Redis job in case it ever gets destroyed.

• NUXT_SESSION_PASSWORD – At least 32 random characters. Used to encrypt access tokens.
• REDIS_PASSWORD – Redis password to use for both Nuxt and the Redis container.
• TOOL_OAUTH_CLIENT_ID – Wikimedia OAuth client ID from m:Special:OAuthConsumerRegistration
• TOOL_OAUTH_CLIENT_SECRET – Wikimedia OAuth client secret from m:Special:OAuthConsumerRegistration
• TOOL_OAUTH_START – OAuth authorization flow start URL. Usually set to https://meta.wikimedia.org/w/rest.php/oauth2/authorize
• TOOL_OAUTH_END – OAuth access token request URL. Usually set to https://meta.wikimedia.org/w/rest.php/oauth2/access_token
• TOOL_OAUTH_REDIRECT_URI – OAuth redirect URI. This should be https://unwatchlist.toolforge.org/login on production.
• TOOL_TOOLSDB_USER and TOOL_TOOLSDB_PASSWORD (provided by Toolforge)
• TOOL_REPLICA_USER and TOOL_REPLICA_PASSWORD (provided by Toolforge)

• Toolforge tools
• Apache licensed tools