/vps-init

VPS init script for Ubuntu systems

Primary LanguageShellMIT LicenseMIT

vps-init

vps-init quickly setup a safe and clean environment on a VPS on an ubuntu system (preferred 16.04).

Table of Contents

Getting started

VPS prerequisites

Be sure you're on a fresh install of your VPS and root access is granted through SSH.

Client prerequisites

Be sure SSH is installed on your machine before continuing. To ensure that SSH is installed on your machine, run the following command.

ssh

To setup your SSH keys please refer to Google by searching ssh getting started.

Configuration

Before launching the script to quickly setup your VPS, you can edit some configuration files to customize your installation:

  • vps-install.conf: used to configure your remote host.
  • vps/vps-entrypoint.conf: used to configure user, group, gecos, hostname...
  • vps/ssh/sshd_config.conf: ssh standard configuration file without PermitRootLogin and without PasswordAuthentication. Note that it's recommended to update default port.
  • vps/ssh/id_rsa.pub: your SSH public key to authorize.
  • vps/postfix/main.conf: postfix standard configuration file, you should update your hostname.
  • vps/fail2ban/jail.conf: fail2ban standard jail configuration file, ssh is enabled.

How to use

To run this script, you just have to run the following command in your terminal.

/path/to/vps-init/vps-install.sh

Documentation

If you want to know more about Postfix, Fail2Ban or UFW please refer to official documentations in reference.

Reference

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Contributing

Please read CONTRIBUTING for details on how to contribute.

Licensing

This repository is under this LICENSE.

Changelog

The complete changelog could be found in CHANGELOG.