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

Could we have a more in depth Install guide, please? #236

Open
Nuru0190 opened this issue Sep 9, 2022 · 5 comments
Open

Could we have a more in depth Install guide, please? #236

Nuru0190 opened this issue Sep 9, 2022 · 5 comments

Comments

@Nuru0190
Copy link

Nuru0190 commented Sep 9, 2022

Hello,
This is not a 'feature request" per say, it's rather just a simple request regarding the necessary instructions to get LegacyPlayerV3 to work.

My guild and i have been using Legacy Player for a very long time, and now that it's gone, we are missing the ONE tool we really needed for our weekly raid performance analysis.
I took it upon myself to come to Github and try to get our own Legacy Player site up and running, but my knowledge is extremely limited.... and i really do mean : "extremely".

I managed to install all the programs that were mentionned, : Docker, Docker-compose, Rustup (with Nightly toolchain), Visual Studio Code (with the containers extension), Git.
I made sure that the ports listed were all free.
Up to this point, it seems that all went fine.

However, for the 2nd part of the instructions, this is where i just can't follow.
It says this (i'm on Windows) :
4. Go into the Environment directory and start it using docker-compose -f docker-compose.mac_windows.yml up. (If you want to run it as daemon, append -d)
5. Go into the Backend directory and start the server using ROCKET_ENV=stage cargo run
6. Go into the Webclient directory and install packages npm ci
7. Start the webclient using npm run start:mac/npm run start:windows in the Git shell or some other bash

Well, from the Zip file i downloaded from this Github, i got "LegacyPlayersV3-master".

For instruction 4, inside the Environment folder, i got a file named "docker-compose.mac_windows.yml", which is different than "docker-compose -f docker-compose.mac_windows.yml".
There was no file named "docker-compose -f docker-compose.mac_windows.yml".
What am i supposed to do with that?

For instruction 5, i did check the backend directory, but there was nothing named "ROCKET_ENV=stage cargo run", or even "ROCKET" something... Those files are not in there. What gives?

Same thing for instruction 6 with the Webclient directory, there was no "npm ci" in it.

Again, i'm sorry for being so ignorant regarding this matter, but i really am utterly clueless as to what to do.

Also, for the site deployment, it is instructed to run "docker-compose up -d", ok... But run it using what? The Cmd from Windows? When i type "docker-compose up -d" in it, it tells me "No configuration file provided: not found"
Again, i'm absolutely clueless as to what to do... and no one in the guild is knowledgeable enough with all of this to be able to help.

So here i am, humbly asking for a little help with a more in depth set of instructions that even a complete bozo such as myself can understand and follow.
We would all really appreciate if you could kindly take the time to help.

Thank you.

@ghost
Copy link

ghost commented Sep 20, 2022

Deployment
Install docker and docker-compose
run docker-compose up -d
Website is now available under port 80
For integration into your custom environment, changes must be made to the environment

This is all you need to do

@Nuru0190
Copy link
Author

Nuru0190 commented Sep 22, 2022

Install docker and docker-compose
run docker-compose up -d

Those are the instructions found on the Github page for Legacy Players.
They are extremely basic, to the point where it might work for people who already have some knowledge, but for newbies like myself, i'm sorry to say : it's not nearly enough.

I already was stuck on these instructions before... for hours...
In fact, i posted a screenshot below of the Docker window as i have it on my computer, and even though it says that Compose is included in the install, there's nowhere i can type the "run docker-compose up -d" command.
Do i need to create a volume? Do i need to create a container? Where to type the command? etc...

And this is the very reason why i asked for SPECIFICS.... For some details please.
Could you please give me something more in depth? A more detailled set of instructions than just 'install the program and type xyz"?

Docker

@broizter
Copy link

You're basically asking for someone to explain how to use docker, I think that's outside the scope of what a deployment guide should do. The instructions are very clear if you know the basics of docker.

@JulianN1987
Copy link

Hi, I can help you perhaps. I got it working for my guild as well, however on MacOS where it is much easier... If you're interested, let me know where and how I can help you out.

@broizter
Copy link

broizter commented Sep 30, 2022

Exact instructions for getting everything up and running on Debian based distros.

apt update; apt upgrade -yy
apt install docker.io docker-compose git
git clone https://github.com/Geigerkind/LegacyPlayersV3
cd LegacyPlayersV3
docker-compose up -d

Then visit http://ip-of-server and you're done. The defaults are not very secure though, just a warning.

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

No branches or pull requests

3 participants