{"id":46751,"library":"verdaccio-sqlite-gitlab","title":"Verdaccio SQLite GitLab Auth Plugin","description":"Verdaccio authentication plugin combining SQLite storage with GitLab OAuth integration. Current stable version is 1.0.14. It allows npm registry authentication via GitLab credentials, storing user data in SQLite. Key differentiator is self-contained local auth without external dependencies beyond GitLab for identity. Released under MIT license. Supports Verdaccio 4.x and 5.x.","status":"active","version":"1.0.14","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","sqlite","gitlab","verdaccio","typescript"],"install":[{"cmd":"npm install verdaccio-sqlite-gitlab","lang":"bash","label":"npm"},{"cmd":"yarn add verdaccio-sqlite-gitlab","lang":"bash","label":"yarn"},{"cmd":"pnpm add verdaccio-sqlite-gitlab","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency; verified as an authentication plugin for Verdaccio.","package":"verdaccio","optional":false}],"imports":[{"note":"ESM-only; CommonJS require will fail.","wrong":"const plugin = require('verdaccio-sqlite-gitlab');","symbol":"default","correct":"import plugin from 'verdaccio-sqlite-gitlab';"},{"note":"Export for TypeScript type usage; type import may be needed.","wrong":null,"symbol":"Config","correct":"import { Config } from 'verdaccio-sqlite-gitlab';"},{"note":"Named export, not default export.","wrong":"import SqliteGitlabAuth from 'verdaccio-sqlite-gitlab';","symbol":"SqliteGitlabAuth","correct":"import { SqliteGitlabAuth } from 'verdaccio-sqlite-gitlab';"}],"quickstart":{"code":"// Install: npm install verdaccio-sqlite-gitlab\n// In verdaccio config.yaml:\n// auth:\n//   sqlite-gitlab:\n//     gitlab_url: 'https://gitlab.com'\n//     client_id: process.env.GITLAB_CLIENT_ID ?? ''\n//     client_secret: process.env.GITLAB_CLIENT_SECRET ?? ''\n//     sqlite_db: './data/auth.db'\n\nimport plugin from 'verdaccio-sqlite-gitlab';\n\n// The plugin is loaded automatically by Verdaccioconfig.\n// No manual instantiation needed.","lang":"typescript","description":"Shows installation and minimal configuration for the plugin in Verdaccio's config file, including environment variable usage for GitLab credentials."},"warnings":[{"fix":"Use ESM import syntax or set \"type\": \"module\" in package.json.","message":"Requires ESM; CommonJS require() will throw an error.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Specify an absolute path for 'sqlite_db' in config.","message":"SQLite database path must be writable; if not set, defaults to current working directory.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Pin Verdaccio to 4.x or test with 5.x carefully.","message":"Verdaccio 5 support is experimental; may break with future updates.","severity":"deprecated","affected_versions":"1.0.0 - 1.0.14"},{"fix":"Monitor token expiry and re-authenticate via GitLab OAuth flow.","message":"No built-in token refresh; tokens expire as per GitLab configuration.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.0.14':20 '4':55 '5':58 'allow':22 'auth':4,41 'authent':7,25 'beyond':45 'combin':9 'contain':39 'credenti':28 'current':16 'data':31 'depend':44 'differenti':35 'extern':43 'gitlab':3,13,27,46,62 'ident':48 'integr':15 'javascript':60 'key':34 'licens':52 'local':40 'mit':51 'npm':23 'oauth':14 'plugin':5,8 'registri':24 'releas':49 'self':38 'self-contain':37 'sqlite':2,10,33,61 'stabl':17 'storag':11 'store':29 'support':53 'typescript':64 'user':30 'verdaccio':1,6,54,63 'version':18 'via':26 'without':42 'x':56,59","created_at":"2026-06-07T13:01:27.323368+00:00","updated_at":"2026-06-07T13:01:27.323368+00:00","problems":[{"fix":"Install in the same directory as Verdaccio: npm install verdaccio-sqlite-gitlab","cause":"Plugin not installed or installed globally but used locally.","error":"Error: Cannot find module 'verdaccio-sqlite-gitlab'"},{"fix":"Set GITLAB_CLIENT_ID and GITLAB_CLIENT_SECRET environment variables.","cause":"Missing or undefined environment variables GITLAB_CLIENT_ID or GITLAB_CLIENT_SECRET.","error":"TypeError: Cannot read properties of null (reading 'client_id')"},{"fix":"Delete the SQLite database file and restart Verdaccio.","cause":"Conflicting database schema from previous version of plugin or manual migration.","error":"SQLITE_ERROR: table users already exists"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"verdaccio-sqlite-gitlab","openapi_spec":null,"status_page":null,"smithery":null,"categories":["security"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}