Updated the installation instructions to make them a little friendlier.

Changed the default installation directory to /home/gosora/src/ instead of /home/gosora/
This commit is contained in:
Azareal 2018-08-20 21:37:04 +10:00
parent 7f55429748
commit 2e0f2bc7b6
2 changed files with 20 additions and 10 deletions

View File

@ -39,7 +39,9 @@ Other modern features like alerts, likes, advanced dashboard with live stats (CP
Go 1.10 or newer - You will need to install this. Pick the .msi, if you want everything sorted out for you rather than having to go around updating the environment settings. https://golang.org/doc/install Go 1.10 or newer - You will need to install this. Pick the .msi, if you want everything sorted out for you rather than having to go around updating the environment settings. https://golang.org/doc/install
Git - You may need this for downloading updates via the updater. You might already have this installed on your server. More to come on this here. https://git-scm.com/downloads For Ubuntu, you can consult: https://tecadmin.net/install-go-on-ubuntu/
Git - You may need this for downloading updates via the updater. You might already have this installed on your server, if the `git` commands don't work, then install this. https://git-scm.com/downloads
MySQL Database - You will need to setup a MySQL Database somewhere. A MariaDB Database works equally well and is much faster than MySQL. You could use something like WNMP / XAMPP which have a little PHP script called PhpMyAdmin for managing MySQL databases or you could install MariaDB directly. MySQL Database - You will need to setup a MySQL Database somewhere. A MariaDB Database works equally well and is much faster than MySQL. You could use something like WNMP / XAMPP which have a little PHP script called PhpMyAdmin for managing MySQL databases or you could install MariaDB directly.
@ -51,7 +53,9 @@ We recommend changing the root password (that is the password for the user 'root
You might also want to run `mysql_secure_installation` to further harden (aka make it more secure) MySQL / MariaDB. You might also want to run `mysql_secure_installation` to further harden (aka make it more secure) MySQL / MariaDB.
It's entirely possible that your host already has MySQL installed and ready to go, so you might be able to skip this step, particularly if it's a managed VPS or a shared host (contrary to popular belief, it is possible, although the ecosystem in this regard is extremely immature). Or they might have a quicker and easier method of setting up MySQL. If you're using Ubuntu, you might want to look at: https://www.itzgeek.com/how-tos/linux/ubuntu-how-tos/install-mariadb-on-ubuntu-16-04.html
It's entirely possible that your host already has MySQL installed and ready to go, so you might be able to skip this step, particularly if it's a managed VPS or a shared host. Or they might have a quicker and easier method of setting up MySQL.
# How to download # How to download
@ -65,20 +69,24 @@ On Windows, you might want to try the [GosoraBootstrapper](https://github.com/Az
*Linux* *Linux*
First, you will need to jump to the place where you want to put the code, we will use `/home/gosora` here, but if you want to use something else, then you'll have to modify the service file with your own path (but *never* in a folder where the files are automatically served by a webserver). First, you will need to jump to the place where you want to put the code, we will use `/home/gosora/src/` here, but if you want to use something else, then you'll have to modify the service file with your own path (but *never* in a folder where the files are automatically served by a webserver).
If you place it in `/www/`, `/public_html/` or any similar folder, then there's a chance that your server might be compromised. If you place it in `/www/`, `/public_html/` or any similar folder, then there's a chance that your server might be compromised.
You can navigate to your installation of Gosora by typing the following six commands into the console and hitting enter: You can navigate to your installation of Gosora by typing the following commands into the console and hitting enter:
cd /home/ cd /home/
git clone https://github.com/Azareal/Gosora mkdir gosora
mv Gosora gosora
cd gosora cd gosora
git clone https://github.com/Azareal/Gosora
mv Gosora src
cd src
chmod 755 ./install-linux chmod 755 ./install-linux
./install-linux ./install-linux
@ -99,6 +107,8 @@ Run install.bat, e.g. double-click on it. You will also have to start-up MySQL,
Follow the instructions shown on the screen. Follow the instructions shown on the screen.
To navigate to the folder the software is in at any time in the future, you can just type `cd` followed by the folder's name, e.g. `cd /home/gosora/src/` and then you can run your commands. cd stands for change directory.
# Running the program # Running the program
@ -214,7 +224,7 @@ If it does, then please open a bug report, so I can look into why they're not wo
# Updating the software # Updating the software
The update system is currently under development, however if you have Git installed, then you can run `dev-update.bat` or `dev-update-linux` to update your instance to the latest commit and to update the associated database schema, etc. The update system is currently under development, but you can run `dev-update.bat` or `dev-update-linux` to update your instance to the latest commit and to update the associated database schema, etc.
In addition to this, you can update the dependencies without updating Gosora by running `update-deps.bat` or `./update-deps-linux` (.bat is for Windows, the other for Linux as the names would suggest). In addition to this, you can update the dependencies without updating Gosora by running `update-deps.bat` or `./update-deps-linux` (.bat is for Windows, the other for Linux as the names would suggest).

View File

@ -11,9 +11,9 @@ Type=simple
Restart=on-failure Restart=on-failure
RestartSec=10 RestartSec=10
# Set these to the location of Gosora # Set these to the location of Gosora
WorkingDirectory=/home/gosora WorkingDirectory=/home/gosora/src
# Make sure you manually run pre-run-linux before you start the service # Make sure you manually run pre-run-linux before you start the service
ExecStart=/home/gosora/Gosora ExecStart=/home/gosora/src/Gosora
# If things don't work for some reason, try putting # in-front of the following three lines until it does and open an issue on the bug tracker # If things don't work for some reason, try putting # in-front of the following three lines until it does and open an issue on the bug tracker
ProtectSystem=full ProtectSystem=full