← Directory

Chromium

Chromium is the LinuxServer.io Docker container that packages the open-source Chromium browser for headless automation, web scraping, and browser testing.

  • Media Applications
  • Media Servers
  • Network Services
  • Productivity
  • Tools & Utilities
Chromium is the LinuxServer.io Docker container that packages the open-source Chromium browser for headless automation, web scraping, and browser testing. It ships as a regularly updated container with simple user and group ID mapping and a persistent /config volume, giving self-hosters a dependable base for browser pipelines and scraping tasks.

Platform availability

Available on 3 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel
  • ZimaOS
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

75/100 Good

Maintained
100last commit 13 days ago
Popular
52402 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 12 days ago

GitHub stars
402
Open issues
2
Last commit
2026-09-30
Latest release
d759a0f5-ls56
License
GPL-3.0
Activity
steady

Checked 7 days ago - source: GitHub (linuxserver/docker-chromium)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 15 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install a local Chromium binary first If you are setting up local development with Playwright, a tool that controls a browser, run npx playwright install chromium before launching anything. This downloads the actual Chromium browser file, so Playwright can find and start it instead of failing immediately. source
  • Tell your code where Chromium is When your code uses a browser-control tool such as Puppeteer or Playwright, set executablePath, which is the exact browser file location, to the value from the @sparticuz/chromium package. Also include the package's args list, which are the startup options Chromium needs, so the browser can launch instead of failing. source
  • Set Lambda environment paths If you are using AWS Lambda, a cloud service that runs code in short bursts, use the package's setupLambdaEnvironment helper to set the required environment paths for fonts, home files, and system libraries. These tell the browser where it can find its supporting files, so it can start inside the restricted Lambda sandbox. source
  • User and group mapping Set the PUID and PGID environment variables to your host user's numeric IDs so the container can read and write the /config volume, then persist /config to keep the browser profile between runs. source

Fetched 6 days ago - each note links to its source

Alternatives (12)

  • Brave - The Brave browser(https://brave.com/) is a fast, private and secure web browser for PC, Mac and mobile.
  • Fifo - Fifo is a fast, free, and secure web browser designed to respect your privacy.
  • Floorp - Open-source web browser built on Firefox, prioritizing privacy and anonymity while offering a Chromium-like interface, user customization,…
  • Google Chrome - Web browser built on an open-source platform featuring multiple account support, integrated password manager, dark mode, real-time translat…
  • Helium Browser - Chromium-based browser with preinstalled open-source blockers, default anti-tracking features, no data collection, full extension support,…
  • IronFox - IronFox is a fork of DivestOS's Mull Browser based on Firefox.
  • Mozilla Firefox - Open-source browser with Gecko engine, supporting HTML add-ons and providing privacy features like Enhanced Tracking Protection and third-p…
  • Opera - Opera is a multi-platform web browser built on the Chromium engine and developed by its namesake company, Opera, that distinguishes itself…
  • Tor Browser - Tor Browser is an anonymized web browser that routes all traffic through the Tor network to conceal your identity, location, and online act…
  • Vivaldi - Vivaldi(https://vivaldi.com/) is a Norwegian freeware, cross-platform web browser with a built-in email client developed by Vivaldi Technol…
  • Waterfox - Waterfox is an open-source, privacy-focused browser based on the popular open source browser with a red panda as a mascot.
  • Zen Browser - Privacy-centric, open-source browser with unique UI features like vertical tabs, Split View, and Zen Glance, focusing on security and tranq…

Checked 12 days ago - source: AlternativeTo

Common questions

How can I set the container user and group for the LinuxServer.io Chromium image?

Set PUID and PGID, which the LinuxServer.io container provides for easy user and group mapping.

Is there a self-hosted sync server for Chromium bookmarks and add-ons?

The source only records the question from a self-hoster; it does not name or confirm a supported self-hosted sync server.

Answers sourced from github.com, www.reddit.com

Community

Collected 9 days ago - public community threads