This guide walks through a self-hosted installation of Part-DB.
For Docker installation, see Docker.
Part-DB can be deployed using multiple methods depending on your infrastructure:
Install Git to clone the project repository.
sudo apt-get update && sudo apt-get install -y git
Create a dedicated directory for Part-DB:
mkdir -p /opt/part-db
cd /opt/part-db
Create a docker-compose.yml file with the following content:
version: '3.8'
services:
part-db:
image: ghcr.io/part-db/part-db:2.6.0 # Use latest stable version
restart: unless-stopped
ports:
- "8080:8080" # Adjust if needed
volumes:
- ./data:/data
- ./attachments:/attachments
- ./config:/config
environment:
- PARTDB_DATABASE_URL=sqlite:///data/database.sqlite
- PARTDB_ATTACHMENTS_PATH=/attachments
- PARTDB_BASE_URL=https://your-domain.com # Update with your domain
- PARTDB_DEFAULT_LOCALE=en # Set your preferred language
depends_on:
- db
networks:
- part-db-network
db:
image: mysql:8.0
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: strong_root_password
MYSQL_DATABASE: partdb
MYSQL_USER: partdb_user
MYSQL_PASSWORD: strong_partdb_password
volumes:
- ./mysql-data:/var/lib/mysql
networks:
- part-db-network
networks:
part-db-network:
driver: bridge
Use Docker Compose to start services in the background.
docker compose up -d
For direct installation on Debian systems, refer to the official documentation at docs.part-db.de.
For container orchestration environments, Part-DB can be deployed using Helm charts. Check the official repository for the latest Helm chart.
After installation, complete the following:
http://your-server-ip:8080 or your configured domainPrefer automation? See Part-DB Ansible Setup for an example playbook.
Prefer containers? See Part-DB Docker Setup.
Any questions?
Feel free to contact us. Find all contact information on our contact page.