a
/
gosora
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
README.md
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
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.
@ -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.
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
@ -65,20 +69,24 @@ On Windows, you might want to try the [GosoraBootstrapper](https://github.com/Az
*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.
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/
git clone https://github.com/Azareal/Gosora
mv Gosora gosora
mkdir gosora
cd gosora
git clone https://github.com/Azareal/Gosora
mv Gosora src
cd src
chmod 755 ./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.
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
@ -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
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).

4
gosora_example.service
View File

@ -11,9 +11,9 @@ Type=simple
Restart=on-failure
RestartSec=10
# 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
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
ProtectSystem=full