Method ensureConfigExists

server/modules/configModule.js:201–256

()

  }

  ensureConfigExists() {
    // If config already exists, nothing to do
    if (fs.existsSync(this.configPath)) {
      return;
    }

    logger.info('Auto-creating config.json from config.example.json template');

    // Ensure config directory exists
    const configDir = path.dirname(this.configPath);
    if (!fs.existsSync(configDir)) {
      fs.mkdirSync(configDir, { recursive: true });
      logger.info({ path: configDir }, 'Created config directory');
    }

    // Load config.example.json (will throw if not found - which is required)
    const examplePath = this.getConfigExamplePath();
    const exampleContent = fs.readFileSync(examplePath, 'utf8');
    const defaultConfig = JSON.parse(exampleContent);

    // Remove comment-only keys
    delete defaultConfig['//comment'];

    // Generate UUID for this instance
    defaultConfig.uuid = uuidv4();

    // Apply platform-specific environment variable overrides
    if (process.env.PLEX_URL) {
      defaultConfig.plexUrl = process.env.PLEX_URL;
      logger.info({ plexUrl: process.env.PLEX_URL }, 'Applied PLEX_URL from environment');
    }

    // Write the config file and provide actionable guidance if permissions fail
    try {
      // mode 0o640 keeps plexApiKey and other secrets out of world-readable (umask is 0o002 → 0o664 default)
      fs.writeFileSync(this.configPath, JSON.stringify(defaultConfig, null, 2), { mode: 0o640 });
      this.tightenConfigPermissions();
      logger.info({ configPath: this.configPath }, 'Created config.json from template');
    } catch (error) {
      if (error.code === 'EACCES') {
        const uid = typeof process.getuid === 'function' ? process.getuid() : null;
        const gid = typeof process.getgid === 'function' ? process.getgid() : null;
        logger.error(
          {
            configPath: this.configPath,
            uid,
            gid,
            youtarrUid: process.env.YOUTARR_UID,
            youtarrGid: process.env.YOUTARR_GID,
          },
          'Unable to write config.json because bind-mounted config directory is not writable. Ensure host ownership matches YOUTARR_UID/YOUTARR_GID (see README manual compose instructions).'
        );
      }
      throw error;
    }
  }

  getConfig() {