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:
parent
7f55429748
commit
2e0f2bc7b6
26
README.md
26
README.md
|
@ -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).
|
||||||
|
|
||||||
|
|
|
@ -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
|
||||||
|
|
Loading…
Reference in New Issue