PartScout

PartScout

Docker app from ZappyZap's Repository

PartScout searches several electronic component suppliers at once from a web interface: prices, stock, photos and BOMs, with multiple users and a French or English interface.

Overview
PartScout searches several electronic component suppliers at once from a web interface: prices, stock, photos and BOMs, with multiple users and a French or English interface. You need your own API keys from each supplier. Derived from Win-PartsFinder by Ian Johnston; personal and non-commercial use only (see LICENSE and NOTICE.md in the project). Generate the Master Key and the Setup Token in the Unraid terminal with: openssl rand -base64 32 Keep the Master Key somewhere safe, outside appdata: if you lose it, you will have to enter your API keys again. The image has no shell, so the Console button does not work.

PartScout logo

PartScout

English · Français

Search for an electronic part at several suppliers at once, and compare stock, prices, price breaks, MOQ, lifecycle and datasheets. A web app that runs in Docker, for personal, non-commercial use.

A web version derived from Win-PartsFinder, © 2026 Ian Johnston. Terms: LICENSE and NOTICE.md.

Built with AI

In the interest of transparency: most of PartScout's code, tests and documentation were written by an AI assistant (Claude, by Anthropic), under my direction. I decided what to build, reviewed the results, and tested the app against the real supplier APIs before publishing it. If AI-assisted software is not for you, that is perfectly fine: feel free to pass on this one. Bug reports are welcome either way.

Results grouped by part Grouped by part, with every offer for the part and its price breaks. Demo data.

Results by offer One line per offer, sortable on several columns, with movable columns. Demo data.

The interface is in English and French: use the FR/EN button at the top. The language belongs to the account, on all its devices; the browser's language only decides the very first visit. The default suppliers, currency and DigiKey site are set for Canada; change them in Settings too.

Getting started

You need Docker with the compose plugin.

mkdir partscout && cd partscout
curl -fsSLO https://raw.githubusercontent.com/devzwf/partscout/main/docker-compose.yml
curl -fsSL -o .env https://raw.githubusercontent.com/devzwf/partscout/main/.env.example
chmod 600 .env    # then replace both change-me values: openssl rand -base64 32
docker compose up -d                       # http://host:5070
docker compose --profile demo up -d demo   # optional demo with made-up data: http://host:5071

On first access, the app asks for the setup token (PARTSCOUT_SETUP_TOKEN) and has you choose a password. Then add your API keys in Settings. A supplier without a key stays available as a link to its website. Each user needs their own keys, so do not share an instance publicly on yours.

Supplier API keys: each supplier has its own developer portal (DigiKey, Mouser, element14, TME). Create an account there and follow their terms of use.

Several users: the first account is the administrator, who creates the others in Settings; there is no public sign-up. Each person has their own language, API keys, settings, BOMs and history. Use HTTPS (a reverse proxy) as soon as several people sign in: otherwise passwords and API keys travel in clear text over the network.

Not for the Internet: PartScout is meant for a home network or a private VPN. See SECURITY.md.

Back up the data folder and the .env file: without the master key, you have to re-enter your API keys. Every hour the app writes a consistent copy of its database to backups/, one per day, kept for 14 days.

Restoring: stop the container, remove partscout.db, partscout.db-wal and partscout.db-shm, copy backups/partscout-YYYY-MM-DD.db to partscout.db (owner uid 1654), then start it again. Do not use ports 5060 and 5061: browsers block them.

HTTPS: docker compose --profile https up -d adds Caddy in front of the app. It serves the certificate files found in PARTSCOUT_CERT_DIR and does not request certificates itself, so renew them with your own tool and restart partscout-caddy afterwards. See .env.example. Then set PARTSCOUT_PUBLISH=127.0.0.1:5070 and PARTSCOUT_COOKIE_SECURE=always, so the session cookie is never sent over plain HTTP. Keep the default (auto) only for plain HTTP on a local network.

Upgrading

Put the new version in PARTSCOUT_VERSION (.env), then docker compose up -d. To go back, restore the old value. Changes are listed in CHANGELOG.md.

Building it yourself

git clone https://github.com/devzwf/partscout.git && cd partscout
tools/build-image.sh    # local image partscout:<VERSION>, nothing is pushed

Then set PARTSCOUT_IMAGE=partscout and PARTSCOUT_PULL_POLICY=never in .env. To release a new version: change VERSION, commit, run tools/build-image.sh.

Layout

Folder Contents
backend/src/PartScout.Suppliers Supplier code taken from Linux-PartsFinder, changed as little as possible
backend/src/PartScout.Api ASP.NET Core API: sign-in, key vault, streaming search, BOM, demo mode
backend/tests API tests
frontend React interface; business logic in src/lib/parts.ts, translations in src/i18n.ts
tests/e2e Full journey in Chromium
upstream Untouched copy of the files taken, and the original commit
tools upstream-diff.sh (the author's changes), ci-e2e.sh (browser journey in Docker), build-image.sh

Tests

docker build --target backend-test .   # API tests
(cd frontend && npm test)              # interface logic
docker build -t partscout:test . && tools/ci-e2e.sh partscout:test   # browser journey, on a throwaway demo

Demo mode (PARTSCOUT_DEMO=1) simulates API responses based on the parser code. It does not replace a test against the real APIs.

Contributing

Issues and pull requests are welcome, in English or French; please use the templates. Code comments are in French. Contributions are distributed under the project's terms (see LICENSE), including the non-commercial restriction.

Categories

Download Statistics

126
Total Downloads

Related apps

Links

Details

Repository
devzwf/partscout:latest
Last Updated2026-11-15
First Seen2026-11-16

Runtime arguments

Web UI
http://[IP]:[PORT:8080]/
Network
bridge
Shell
sh
Privileged
false
Extra Params
--user 99:100 --restart=unless-stopped --read-only --tmpfs /tmp --cap-drop=ALL --security-opt=no-new-privileges

Template configuration

Web UI PortPorttcp

Web interface. Avoid 5060 and 5061, which browsers block.

Target
8080
Default
5070
Value
5070
DataPathrw

Database, settings and daily backups. Unraid creates this folder. If you choose an existing one, it must belong to nobody:users (99:100).

Target
/data
Default
/mnt/user/appdata/partscout/data
Value
/mnt/user/appdata/partscout/data
Master KeyVariable

Encrypts your supplier API keys. Generate it with: openssl rand -base64 32. If you lose it, you will have to enter your API keys again.

Target
PARTSCOUT_MASTER_KEY
Setup TokenVariable

Asked for once, when the password is created. Generate it with: openssl rand -base64 32

Target
PARTSCOUT_SETUP_TOKEN
Trusted Proxy IPVariable

Behind a reverse proxy: its IP address, the only source trusted for X-Forwarded-* headers. Leave empty otherwise.

Target
PARTSCOUT_TRUSTED_PROXY
Secure CookieVariable

always: the session cookie is only ever sent over HTTPS. Set it when PartScout is reached through HTTPS (reverse proxy). auto: Secure only when the request is HTTPS, so plain HTTP keeps working on your LAN.

Target
PARTSCOUT_COOKIE_SECURE
Default
auto