Skip to content

sitemapxml/USet

Repository files navigation

Maintenance Maintaner GitHub issues GitHub release GitHub commits since tagged version made-with-bash GitHub license

USet

Server configuration script

IMPORTANT NOTICE: Version 3 is here! 🎉 🎉 🎉 This is the biggest update from the beginning of this project. There are many improvements in this release, but most notable are full support for command line options, visual installation wizard, support for configuration files, custom scripts, installation profiles, and completely revised project structure. You can check the Change Log for more details.

Supported systems:

OS
Debian logo Ubuntu Logo
VERSION 9 or newer 18 or newer

Running the script

git clone https://github.com/sitemapxml/uset.git && cd uset && chmod +x uset
./uset -i

After running the script, you should see welcome screen like this:

If you want to save screen output you can do it simply by using tee command:

./uset | tee log.txt

If you do so, it is advisable to turn off screen coloring by passing --colors no option.

Before running the script you should check if the name servers point to your server IP address. The easiest way to do it, is by using host command:

host example.com

Which will return: example.com has address 93.184.216.34

If you don't see your IP, or you get something like this: Host example.com not found: 3(NXDOMAIN)

It means that DNS propagation is not complete and you probably need to wait until it's done. Configuring the server without domain name is possible, but in that case you won't be able to install Let's Encrypt SSL certificate.

Configuration options

If you want to fine-tune installation options, you can edit default.conf file inside config directory, or by passing apropriate options.
Configuration file must be edited before running the script, otherwise it would not take effect.

If you use this script often, you probably don't want to see welcome screen.
Welcome screen can be turned off by passing --welcome no option.

Password backup file

The script will automatically save usernames and passwords in a text file. You can disable this behavior by using the --save-passwords no option. The passwords are saved in plain text, so this is not recommended but sometimes can be useful. Passwords will be saved to a file named data.txt inside directory .data

Language settings

USet supports localization, so if you want to localize it to your own language, you can copy english translation inside languages/en.txt and name it according to your preferences.

If you want to contribute to the project by making translations, then filename of the translation file should be two letter language code following ISO 639-1

Uninstall options

To uninstall installed software you can run uninstall.sh file inside tools directory.

History

This script is made from two repositories: LAMP and LEMP which were merged into one repository called uset_alfa, from which is this project created. LAMP was first created and LEMP was created as a fork of LAMP which were adjusted to NGINX. Version 1.3.2 of LAMP script is used as beginning version of USet family, so LAMP repository is not under active development anymore, but it will remain public anyway.


Contributions and License

If you experience any bug or you have some idea for improvement, feel free to open up new issue, or if you are familiar with bash you can fork the repository and open up a pull request.

Before submitting new changes, please read Contributing guidelines

License is MIT, so you are free to use it in both personal and commercial purposes according to the terms of the License.