streams/contrib/easyinstall/INSTALL.md
2022-12-20 17:49:09 +11:00

2.6 KiB
Raw Blame History

How to install your website

Disclaimer

  • This script does work with Debian 11 only.
  • This script has to be used on a fresh debian install only (it does not take account for a possibly already installed and configured webserver or sql implementation). You may use it to install more than one website on the same computer as long as you use a single webserver.

First step: setting up your system

After logging into your brand new Debian you will need to run the following commands (as root):

apt-get install git

Git will allow you to download the necessary software from the Streams repository.

mkdir -p /var/www
cd /var/www

This first creates the directory where your web server will find the install folder of your website, then goes to the directory.

git clone https://codeberg.org/streams/streams.git mywebsite

This will download all the software you need in /var/www/mywebsite. You can replace "mywebsite" with any name you like (which you'll have to do if you plan to have more than one website running on your system)

cd website/.easyinstall

This brings you to the subfolder where the tools are available, i.e. the setup script.

Next step: installing your website

There are two ways to proceed here, the first one is recommended if you're not familiar with the terminal mode.

The beginner-friendly way

Simply run the setup script:

./server-setup.sh

A series of dialog boxes will appear, in which you can enter the necessary information. There is a "Beginner" and an "Advanced" mode. The second one will allow you to access a few extra settings.

There are only four mandatory settings you need to provide: your domain name, your e-mail address, the webserver your will be using (Apache or Nginx), a password for your database. Once everything is ready, the actual install process will begin and you wont have to do anything during the install.

The (little) more advanced way

You can enter all your installation settings in a configuration file:

cp server-config.txt.template server-config.txt
nano server-config.txt

First be sure to read all the comments carefully. Then enter your values: database password, domain, e-mail, webserver, etc.. Then you can run the setup script:

./server-setup.sh

Then simply wait until the script is finished.

Final step

Open your domain with a browser and step throught the initial configuration of your website. You will need to re-enter a few settings (database & password, admin e-mail…). You will then create your first user, starting with the admin is a great idea.

And thats it, you can now log in your website and start adding content to it!