Super Simple Guide to the Installer
Hey there! So you want to install some cool stuff from PlexDevelopment, but maybe you're not a computer wizard? No problem! This guide explains things like you're five (okay, maybe ten).
« Back to Installer
What is This Thing?
Think of this installer as a helpful robot. You tell it what Plex product you want (like PlexTickets or PlexStore), and it does all the tricky setup stuff on your Linux server for you.
Normally, setting these things up involves lots of typing weird commands. This robot does most of that typing for you!
Super Important: This robot is built by someone else (bali0531), NOT the official PlexDevelopment team. It's like getting help from a friendly neighbor instead of the official company. It usually works great, but it's not official support.
How Do I Use the Robot? (Quick Install)
This is the easiest way. It's like telling your robot helper, "Go do the thing!"
- Connect to Your Server: You need to be talking to your Linux server. This usually means using a program like PuTTY (on Windows) or Terminal (on Mac/Linux) and logging in. You'll see a blinking cursor waiting for commands.
- Choose Stable or Beta: On the main installer page, there's a little switch next to "Quick Installation".
- Stable (Green): Safer, tested more. Use this normally.
- Beta (Orange): Newer, might break. Use if you like testing.
Make sure the switch is set how you want it.
- Copy the Magic Spell: Find the black box below the switch with the command inside (it starts with
curl
). Click the "Copy" button next to it.
- Paste and Go: Go back to your server terminal window. Right-click (or use Shift+Insert or Cmd+V) to paste the command you copied. It should look something like this:
curl -sSL https://plexdev.live/install.sh | bash -i
(Or it might say beta.sh
if you chose the Beta option).
- Hit Enter: Press the Enter key on your keyboard.
- Follow Instructions: The robot (installer script) will start working. It will ask you some questions, like:
- Which product do you want to install?
- What website address (domain) do you want to use? (e.g.,
tickets.mycoolsite.com
) - *Only asked for products that need a website.*
- What's your email? (For website security stuff) - *Only asked if setting up a website.*
Just answer the questions carefully. If you're unsure, the script often suggests a default answer.
That's it for starting! The robot does the rest.
What About Manual Install?
If you like doing things step-by-step, use the "Manual Install" tab on the main page.
- Choose Stable/Beta using the switch (it changes the commands in this tab too).
- Copy the command from "Step 1: Download" and run it on your server.
- Copy the command from "Step 2: Make it Executable" and run it.
- Copy the command from "Step 3: Run It" and run it.
- Now, follow the instructions the script gives you (same as step 6 in Quick Install).
What Does the Robot Actually Do?
While you watch the text scroll by, the installer is busy doing these things:
- Checks Your Server: Figures out what kind of Linux you have (like Ubuntu, Debian, etc.).
- Gets Tools: Installs programs your new Plex product needs to run (like Node.js, which is a runtime; Nginx, which is a web server; Certbot, for security).
- Unpacks the Product: Takes the product files (which you provide as a .zip or .rar) and puts them in the right place (usually
/var/www/plex/PRODUCT_NAME
).
- Installs More Tools (for the product): Runs
npm install
inside the product's folder to get any extra bits it needs.
- Sets Up the Website (If Needed): Configures the Nginx web server so when people visit your chosen domain (like
tickets.mycoolsite.com
), they see the Plex product. *Doesn't do this for bot-only products like PlexTickets without the dashboard.*
- Adds Security (HTTPS) (If Needed): Uses Certbot and Let's Encrypt to get a free SSL certificate. This makes the little padlock appear in browsers and keeps connections secure (HTTPS instead of HTTP). *Only done if a website is set up.*
- Makes it Run Forever (Almost): Creates a 'systemd service'. This is like telling the server, "Make sure this program is always running, even if you restart."
Okay, It Finished. Now What?
If everything went well, the script will tell you it's done and usually show you:
- The Website Address (If Applicable): The
https://your.domain.com
address you can visit in your web browser.
- How to Control the Service: Commands like:
sudo systemctl status plex-PRODUCT_NAME
(Check if it's running)
sudo systemctl stop plex-PRODUCT_NAME
(Stop it)
sudo systemctl start plex-PRODUCT_NAME
(Start it)
sudo systemctl restart plex-PRODUCT_NAME
(Restart it if you change config)
(Replace PRODUCT_NAME
with the actual product, like plextickets
).
- How to See Logs: A command like
sudo journalctl -u plex-PRODUCT_NAME -f
lets you see messages from the running program, useful if something seems wrong.
- Configuration File: It might tell you where the product's settings file is (like
config.yml
) so you can customize it later. You might need to edit this file to add bot tokens or other settings!
If it installed a website, go visit the address it gave you! Otherwise, make sure you configure the product using its config file and then start/restart the service.
Something Went Wrong!
Uh oh. Sometimes things break.
- Read the Red Text: The installer usually prints error messages in RED. Read those carefully, they often give clues.
- Check Logs: If the product installed but isn't working right, use the
journalctl
command mentioned above to see its logs.
- Ask for Help (Unofficially): Since this is unofficial, you can try asking in places where the creator (bali0531) might be, but remember there's no guarantee of official support. Provide the error messages you saw!
- Try Again?: Sometimes just running the installer again fixes temporary glitches. If it asks to remove an existing installation first, say yes.