Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Installation instructions for prebuilt distribution #719

Open
XenonofArcticus opened this issue Sep 28, 2024 · 1 comment
Open

Installation instructions for prebuilt distribution #719

XenonofArcticus opened this issue Sep 28, 2024 · 1 comment
Labels
enhancement New feature or request

Comments

@XenonofArcticus
Copy link

I am a mentor for a FIRST FRC robotics team who wishes to use Part-DB to manage our inventory. We have a web host available that allows us PHP/MariaDB hosting in a medium-restricted environment (we can add whatever we want to the hosting folder and our database, but can't really install new tools on the server). Docker isn't really an option for us at this point, nor is installing composer, yarn, etc and building everything.

I'm trying to install a pre-built Part-DB as mentioned here:
https://www.reddit.com/r/diyelectronics/comments/12ii4na/comment/ju2lkq4/

I downloaded an extracted a prebuilt release from
https://github.com/Part-DB/Part-DB-server/releases/download/v1.14.0/Full.Part-DB.including.dependencies.and.built.assets.zip

While I'm fairly experienced with installing and configuring pre-built PHP/MySQL web apps, there's really no documentation for installing a pre-built Part-DB. Just putting the contents of public/ into our public webserver folder fails because it's trying to pull files from the vendor/ folder higher up in the folder structure. There's no indication about where to put the env.local file with the config changes and database credentials.

The full Debian install is a bit overkill, as in the control-panel-centric environment, we have a pre-created webhosting folder and database, and all of the dependencies are said to be pre-built and included. I just need some guidance about how to unpack and configure the contents of the prebuilt release for my webhosting environment.

@XenonofArcticus XenonofArcticus added the enhancement New feature or request label Sep 28, 2024
@XenonofArcticus XenonofArcticus changed the title Installatio instructions for Installation instructions for prebuilt distribution Sep 28, 2024
@jbtronics
Copy link
Member

You basically just need to unpack the zip file, to a web server folder.
The critical part is that you need to point the DocumentRoot of the webserver to the "public/" folder. If and how that is possible, will depend on the the control panel you use, and what kind of rights the hoster has given you. You should look if you have a direct option for it, or if you have the possibility to add "additional apache directives" (and if you dont have this option, you should ask an admin of the hoster to do this for you). You can probably also use the rewrite engine, but I never tried it and you still need to overwrite the webserver config with an .htaccess file.

Also, you still need some kind of SSH or terminal access, to performs the database migrations. But for this a jailed environment running as web user with access to PHP is enough.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants