# PartScout

PartScout is a self-hosted Docker web app that searches several electronic component suppliers at once, comparing stock, prices, price breaks, minimum order quantities, lifecycle status and datasheets for individual. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7737/partscout

## Description

PartScout is a self-hosted Docker web app that searches several electronic component suppliers at once, comparing stock, prices, price breaks, minimum order quantities, lifecycle status and datasheets for individual parts and full bills of materials (BOMs). It supports multiple users, English and French interfaces, and is intended for personal, non-commercial use. You must supply your own API keys from each supplier you want to query. Derived from Win-PartsFinder by Ian Johnston (see LICENSE and NOTICE.md in the repository).

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

46/100 (Fair), based on 3 of 4 factors.
- Maintained: 75 (last commit 6 days ago)
- Popular: 10 (2 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/partscout-1yj1nzt0ex1rb1?q=PartScout
- GitHub: https://github.com/devzwf/partscout

## Common questions

### How do I access PartScout for the first time?

The app asks for the setup token (PARTSCOUT_SETUP_TOKEN) on first access and then has you choose a password. The token is one of the values you replace in the .env file using openssl rand -base64 32.

### Do multiple users need their own supplier API keys?

Yes, each user needs their own keys. Each person has their own API keys, settings, BOMs and history, and the first administrator account creates other accounts in Settings.

### When is a reverse proxy needed?

Use HTTPS with a reverse proxy as soon as several people sign in, otherwise passwords and API keys travel in clear text over the network. The app is intended for a home network or private VPN, not the public Internet.

### What should I back up to preserve full access to PartScout?

Back up the data folder and the .env file. Without the master key, you have to re-enter your supplier API keys.

### Which ports does PartScout use?

The main web interface runs on port 5070. The optional demo profile with made-up data runs on port 5071.

---
Source: Our Local Host (https://ourlocalhost.com/app/7737/partscout), the self-hosted and open-source app directory.
