Installation Bare Metal

Bare Metal & Prebuilt Binaries Installation

If you prefer not to use Docker, Bindarr provides prebuilt self-contained server binaries for Windows, Linux, and macOS, as well as instructions to build and run directly from source.

---

Method 1: Prebuilt Release Binaries

Prebuilt binaries bundle Node.js, the backend API server, native image libraries, and the compiled React frontend into a portable archive.

Download

Download the appropriate archive for your operating system from the Latest GitHub Release:

Operating System	Architecture	Archive Package
Windows	x64	Bindarr-Server-windows-x64.zip
Linux	x64	Bindarr-Server-linux-x64.tar.gz
macOS	Apple Silicon (arm64)	Bindarr-Server-macos-arm64.tar.gz

---

Windows Installation

1. Download and extract Bindarr-Server-windows-x64.zip to your preferred folder (e.g. C:\Bindarr).
2. (Optional) Create a .env file in the folder to customize ports or API keys (see Docker Configuration).
3. Double-click bindarr-server.exe to start the server.
4. Open your browser and navigate to http://localhost:3001.

---

Linux Installation

1. Extract the tarball:

   tar -xzf Bindarr-Server-linux-x64.tar.gz -C /opt/bindarr
   cd /opt/bindarr

2. Make the binary executable:

   chmod +x bindarr-server

3. Run the binary:

   ./bindarr-server

4. Access the web interface at http://localhost:3001.

---

macOS Installation (Apple Silicon)

1. Extract the tarball:

   tar -xzf Bindarr-Server-macos-arm64.tar.gz
   cd Bindarr-Server-macos-arm64
   chmod +x bindarr-server

2. Start the server:

   ./bindarr-server

3. Open http://localhost:3001 in Safari or Chrome.

---

Method 2: Running from Source

Running directly from source requires Node.js 18.x or higher and npm 9.x or higher.

1. Clone the Repository

git clone https://github.com/thenotoriousJeremy/bindarr.git
cd bindarr

2. Install Dependencies

Install root, backend, and frontend dependencies in one command:

npm run install:all

3. Fetch Neural Network Models

Fetch the ONNX scanning models:

cd backend
node scripts/fetch-models.mjs --catalogs
cd ..

4. Run in Development Mode

npm run dev

• Frontend: https://localhost:5173 (Vite dev server with hot reload and self-signed HTTPS for camera access).
• Backend API: http://localhost:3001.

5. Build for Production

# Build the production frontend assets
npm run build --workspace=frontend

# Start production server
npm start --workspace=backend

---

Running as a Linux Systemd Service

To keep Bindarr running in the background and automatically restart on server reboots, create a systemd service unit.

Create /etc/systemd/system/bindarr.service:

[Unit]
Description=Bindarr Trading Card Collection Manager
After=network.target

[Service]
Type=simple
User=bindarr
Group=bindarr
WorkingDirectory=/opt/bindarr
ExecStart=/opt/bindarr/bindarr-server
Restart=always
RestartSec=5
Environment=PORT=3001
Environment=HTTPS_PORT=3443
Environment=DB_PATH=/opt/bindarr/data/bindarr.db
Environment=CV_MODEL_DIR=/opt/bindarr/data/models
Environment=TRUST_PROXY=1

[Install]
WantedBy=multi-user.target

Enable and start the service:

sudo systemctl daemon-reload
sudo systemctl enable --now bindarr
sudo systemctl status bindarr