In this repo you can find the docker-compose files for an easy install of Part-DB via Docker.
For the next steps you will need a working installation of Docker and docker-compose.
There are two "stability" levels available:
- stable: Use the files in this folder if you need a very stable and bug-free version. This version maybe lacks some features...
- latest: Use this folder if you want to use the latest features from the master (former nextgen) Branch...
- Copy the folder with you desired stability level in a folder on your computer (or any other device where you want to run Part-DB)
- Go to
docker-compose.yml
and replace in the lineMYSQL_ROOT_PASSWORD:
"changeme" with an unique password (without quotes). You will need this later during Part-DB setup, as the Database root password. If you want to run Part-DB on a TCP port other than 8888, then change the line"8888:80"
underports
as desired. - Start Part-DB with the command
sudo docker-compose up -d
. This will start all required servers and runs them in background. Windows users can use the batch filesserver_start.bat
andserver_stop.bat
to control the server. - Open a Browser and go to
localhost:8888
(or the other port you set in Step 2). You will be redirected to the Installation page of Part-DB. Choose a language and timezone, and a password for the admin user. - On the Database setup page, use
database
as host,partdb
as databasenname, androot
as username. Databasepassword is the one you put intodocker-compose.yml
in Step 2. - Finish the setup and make an database update, when asked. You now can use Part-DB.
- If you want to stop the server, you can do that with
docker-compose down
orserver_stop.bat
If you want to create an custom setup, you can setup the needed docker containers and their connections manually. You will need the following things:
- The Part-DB image: It can be found on Docker Hub as
jbtronics/part-db
. The tags are the same as the stability levels for the docker-compose method - A container running MariaDB/MySQL, which the Part-DB container can access.
- A port forward from Port 80 in the Part-DB container, to the desired port on your host.
- A volume for the Part-DB container for Part-DB's data under
:/var/www/html/data