Error: Failed to launch the browser process
/home/runner/work/app/app/node_modules/puppeteer/.local-chromium/linux-1022525/chrome-linux/chrome: error while loading shared libraries: libatk-1.0.so.0: cannot open shared object file
Error: Failed to launch the browser process
/home/runner/work/app/app/node_modules/puppeteer/.local-chromium/linux-1022525/chrome-linux/chrome: error while loading shared libraries: libatk-1.0.so.0: cannot open shared object file
Error: Failed to launch the browser process
/home/runner/work/app/app/node_modules/puppeteer/.local-chromium/linux-1022525/chrome-linux/chrome: error while loading shared libraries: libatk-1.0.so.0: cannot open shared object file
FROM node:18 # Install Chrome dependencies (this is just the beginning)
RUN apt-get update && apt-get install -y \ chromium-browser \ fonts-liberation \ libatk1.0-0 \ libatk-bridge2.0-0 \ libatspi2.0-0 \ libcairo2 \ libcups2 \ libdbus-1-3 \ libdrm2 \ libgconf-2-4 \ libgdk-pixbuf2.0-0 \ libglib2.0-0 \ libgtk-3-0 \ libicu72 \ libjpeg62-turbo \ libpango-1.0-0 \ libpangocairo-1.0-0 \ libpangoft2-1.0-0 \ libpci3 \ libpixman-1-0 \ libpng16-16 \ libx11-6 \ libx11-xcb1 \ libxcb1 \ libxcomposite1 \ libxcursor1 \ libxdamage1 \ libxext6 \ libxfixes3 \ libxi6 \ libxinerama1 \ libxrandr2 \ libxrender1 \ libxss1 \ libxtst6 \ wget \ && rm -rf /var/lib/apt/lists/* COPY package*.json ./
RUN npm ci COPY . . EXPOSE 3000
CMD ["node", "server.js"]
FROM node:18 # Install Chrome dependencies (this is just the beginning)
RUN apt-get update && apt-get install -y \ chromium-browser \ fonts-liberation \ libatk1.0-0 \ libatk-bridge2.0-0 \ libatspi2.0-0 \ libcairo2 \ libcups2 \ libdbus-1-3 \ libdrm2 \ libgconf-2-4 \ libgdk-pixbuf2.0-0 \ libglib2.0-0 \ libgtk-3-0 \ libicu72 \ libjpeg62-turbo \ libpango-1.0-0 \ libpangocairo-1.0-0 \ libpangoft2-1.0-0 \ libpci3 \ libpixman-1-0 \ libpng16-16 \ libx11-6 \ libx11-xcb1 \ libxcb1 \ libxcomposite1 \ libxcursor1 \ libxdamage1 \ libxext6 \ libxfixes3 \ libxi6 \ libxinerama1 \ libxrandr2 \ libxrender1 \ libxss1 \ libxtst6 \ wget \ && rm -rf /var/lib/apt/lists/* COPY package*.json ./
RUN npm ci COPY . . EXPOSE 3000
CMD ["node", "server.js"]
FROM node:18 # Install Chrome dependencies (this is just the beginning)
RUN apt-get update && apt-get install -y \ chromium-browser \ fonts-liberation \ libatk1.0-0 \ libatk-bridge2.0-0 \ libatspi2.0-0 \ libcairo2 \ libcups2 \ libdbus-1-3 \ libdrm2 \ libgconf-2-4 \ libgdk-pixbuf2.0-0 \ libglib2.0-0 \ libgtk-3-0 \ libicu72 \ libjpeg62-turbo \ libpango-1.0-0 \ libpangocairo-1.0-0 \ libpangoft2-1.0-0 \ libpci3 \ libpixman-1-0 \ libpng16-16 \ libx11-6 \ libx11-xcb1 \ libxcb1 \ libxcomposite1 \ libxcursor1 \ libxdamage1 \ libxext6 \ libxfixes3 \ libxi6 \ libxinerama1 \ libxrandr2 \ libxrender1 \ libxss1 \ libxtst6 \ wget \ && rm -rf /var/lib/apt/lists/* COPY package*.json ./
RUN npm ci COPY . . EXPOSE 3000
CMD ["node", "server.js"]
const fetch = require('node-fetch'); async function takeScreenshot(url) { const response = await fetch('https://api.pagebolt.io/api/v1/screenshot', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.PAGEBOLT_API_KEY}` }, body: JSON.stringify({ url }) }); return response.buffer();
}
const fetch = require('node-fetch'); async function takeScreenshot(url) { const response = await fetch('https://api.pagebolt.io/api/v1/screenshot', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.PAGEBOLT_API_KEY}` }, body: JSON.stringify({ url }) }); return response.buffer();
}
const fetch = require('node-fetch'); async function takeScreenshot(url) { const response = await fetch('https://api.pagebolt.io/api/v1/screenshot', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.PAGEBOLT_API_KEY}` }, body: JSON.stringify({ url }) }); return response.buffer();
}
const express = require('express');
const fetch = require('node-fetch');
const fs = require('fs/promises');
const path = require('path'); const app = express();
app.use(express.json()); const CACHE_DIR = path.join(__dirname, '.cache'); async function takeScreenshot(url) { // Check cache first const cacheKey = Buffer.from(url).toString('hex'); const cachePath = path.join(CACHE_DIR, `${cacheKey}.png`); try { await fs.access(cachePath); return await fs.readFile(cachePath); } catch { // Cache miss, fetch from API } try { const response = await fetch('https://api.pagebolt.io/api/v1/screenshot', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.PAGEBOLT_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ url, width: 1280, height: 720, blockAds: true, blockBanners: true }), timeout: 15000 }); if (!response.ok) { throw new Error(`API returned ${response.status}`); } const buffer = await response.buffer(); // Cache for 7 days try { await fs.mkdir(CACHE_DIR, { recursive: true }); await fs.writeFile(cachePath, buffer); } catch (err) { console.warn('Failed to cache:', err); } return buffer; } catch (error) { console.error('Screenshot failed:', error); throw new Error('Unable to generate screenshot'); }
} app.post('/api/preview', async (req, res) => { const { url } = req.body; if (!url) { return res.status(400).json({ error: 'URL required' }); } try { const imageBuffer = await takeScreenshot(url); res.setHeader('Content-Type', 'image/png'); res.send(imageBuffer); } catch (error) { res.status(500).json({ error: error.message }); }
}); app.listen(3000, () => console.log('Server running on port 3000'));
const express = require('express');
const fetch = require('node-fetch');
const fs = require('fs/promises');
const path = require('path'); const app = express();
app.use(express.json()); const CACHE_DIR = path.join(__dirname, '.cache'); async function takeScreenshot(url) { // Check cache first const cacheKey = Buffer.from(url).toString('hex'); const cachePath = path.join(CACHE_DIR, `${cacheKey}.png`); try { await fs.access(cachePath); return await fs.readFile(cachePath); } catch { // Cache miss, fetch from API } try { const response = await fetch('https://api.pagebolt.io/api/v1/screenshot', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.PAGEBOLT_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ url, width: 1280, height: 720, blockAds: true, blockBanners: true }), timeout: 15000 }); if (!response.ok) { throw new Error(`API returned ${response.status}`); } const buffer = await response.buffer(); // Cache for 7 days try { await fs.mkdir(CACHE_DIR, { recursive: true }); await fs.writeFile(cachePath, buffer); } catch (err) { console.warn('Failed to cache:', err); } return buffer; } catch (error) { console.error('Screenshot failed:', error); throw new Error('Unable to generate screenshot'); }
} app.post('/api/preview', async (req, res) => { const { url } = req.body; if (!url) { return res.status(400).json({ error: 'URL required' }); } try { const imageBuffer = await takeScreenshot(url); res.setHeader('Content-Type', 'image/png'); res.send(imageBuffer); } catch (error) { res.status(500).json({ error: error.message }); }
}); app.listen(3000, () => console.log('Server running on port 3000'));
const express = require('express');
const fetch = require('node-fetch');
const fs = require('fs/promises');
const path = require('path'); const app = express();
app.use(express.json()); const CACHE_DIR = path.join(__dirname, '.cache'); async function takeScreenshot(url) { // Check cache first const cacheKey = Buffer.from(url).toString('hex'); const cachePath = path.join(CACHE_DIR, `${cacheKey}.png`); try { await fs.access(cachePath); return await fs.readFile(cachePath); } catch { // Cache miss, fetch from API } try { const response = await fetch('https://api.pagebolt.io/api/v1/screenshot', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.PAGEBOLT_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ url, width: 1280, height: 720, blockAds: true, blockBanners: true }), timeout: 15000 }); if (!response.ok) { throw new Error(`API returned ${response.status}`); } const buffer = await response.buffer(); // Cache for 7 days try { await fs.mkdir(CACHE_DIR, { recursive: true }); await fs.writeFile(cachePath, buffer); } catch (err) { console.warn('Failed to cache:', err); } return buffer; } catch (error) { console.error('Screenshot failed:', error); throw new Error('Unable to generate screenshot'); }
} app.post('/api/preview', async (req, res) => { const { url } = req.body; if (!url) { return res.status(400).json({ error: 'URL required' }); } try { const imageBuffer = await takeScreenshot(url); res.setHeader('Content-Type', 'image/png'); res.send(imageBuffer); } catch (error) { res.status(500).json({ error: error.message }); }
}); app.listen(3000, () => console.log('Server running on port 3000'));
FROM node:18-alpine WORKDIR /app COPY package*.json ./
RUN npm ci --only=production COPY . . EXPOSE 3000
CMD ["node", "server.js"]
FROM node:18-alpine WORKDIR /app COPY package*.json ./
RUN npm ci --only=production COPY . . EXPOSE 3000
CMD ["node", "server.js"]
FROM node:18-alpine WORKDIR /app COPY package*.json ./
RUN npm ci --only=production COPY . . EXPOSE 3000
CMD ["node", "server.js"] - Chromium binary (100–200MB)
- System libraries (libX11, libxkbcommon, libgconf, libatk, libpangocairo, etc.)
- Font rendering dependencies
- GPU acceleration libraries (optional but recommended) - Without Puppeteer: 200MB
- With Puppeteer: 1.2GB
- Registry storage cost: $0.10/month per image
- CI build time: 2 minutes → 8 minutes
- Cost per deployment: 6 minutes of CI runner time = $0.30 - Base Node app: 50MB
- With Puppeteer (idle): 100–200MB
- With Puppeteer (screenshotting): 300–500MB
- Total: Add $50–100/month to your cloud bill - Debugging Chrome version mismatches
- Managing system library compatibility
- Handling OOM (out of memory) crashes
- Monitoring zombie Chrome processes - Full control over browser rendering
- Ability to interact with the page (clicks, form fills, waiting for elements)
- Running JavaScript that only works in a browser - 85% smaller Docker images
- 10x faster CI builds
- No system dependencies
- No memory overhead
- No Chrome crash debugging
- 99.9% uptime guarantee - You're testing interactive features (clicking, form submission, state changes)
- You need to run JavaScript and verify the rendered output
- You're building a browser automation tool
- You have strict data residency requirements (API can't reach your server) - You just need static screenshots
- You're running in CI/CD and want fast builds
- You want predictable infrastructure costs
- You don't want to manage Chrome in production - Build Docker image with Chrome (10 minutes, 1.2GB)
- Deploy to server (with 2GB RAM to handle concurrent screenshots)
- Set up monitoring for zombie processes
- Schedule cronjob to take screenshots
- Alert on changes
- Cost: $500+/month in infrastructure - Write 50 lines of Node code
- Deploy Docker image (150MB, 90 seconds)
- Set up cronjob to call API
- Alert on changes
- Cost: $29/month for API - Get an API key: pagebolt.dev/pricing — 100 requests free
- Write your screenshot function: (Use the code above)
- Remove Puppeteer from package.json: npm uninstall puppeteer
- Rebuild your Docker image: Watch it shrink from 1.2GB to 150MB
- Deploy: Your builds are now 8x faster
