Easy VPS deployment tool with Nginx Reverse Proxy, SSL, and Docker Compose services

• Getting Started
  • Install and Use
  • Make scripts executable
  • Generate the configuration files
  • Deploy the stack
  • Continue with your setup
• API
• License
• Support

This repository includes all the necessary files and configurations for a quick and easy VPS stack deployment. With just a few commands, you'll have your server up and running in minutes, saving you valuable time to focus on developing your web applications and services.

Start by cloning this repository in your VPS

git clone https://github.com/pariskwsto/vps-stack-mate.git

then cd into project root

cd vps-stack-mate

chmod +x mate.sh && chmod -R +x scripts/

Type the command below to generate the .env and domains.json files.

./mate.sh generate-config-files

# The generation of the `.env` file will ask for your email
# It will be used for SSL certificates

# After the script execution you need to update
# the new `domains.json` file with your domains list

# edit the file
$ nano domains.json

# paste your domains and subdomains list
# ["example.com", "subdomain.example.com"]

# ctrl + x to save and exit

Type the command below to deploy the stack

sudo ./mate.sh deploy-stack

After some domains addition and setup you can continue with the following steps:

• add the services you need in docker-compose.yml file

version: "3.9"

services:
  nginx:
    ...
    ...
  my-service:
    container_name: my-service
    image: hello-world
    ports:
      - "3000:3000"

• add the nginx configuration files you need in nginx/conf directory using the following naming convention
  domain: example.com => conf file: example.com.conf
  and a proxy_pass with the name of the service (e.g. my-service) you want to serve
  

server {
  listen 80;
  server_name example.com;
  server_tokens off;

  location /.well-known/acme-challenge/ {
      root /var/www/certbot;
  }

  location / {
      return 301 https://$host$request_uri;
  }
}

server {
  listen 443 ssl;
  server_name example.com;
  server_tokens off;

  ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
  include /etc/letsencrypt/options-ssl-nginx.conf;
  ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

  location / {
    proxy_pass http://my-service/;
  }
}

• redeploy the stack

./mate.sh reload-stack

This repository is licensed under the MIT License.

For support and questions, please open an issue in the repository or contact the designer directly.