VPSSetup - Automated VPS Deployment Tool

Fast and reliable VPS setup automation tool that eliminates the pain of manual server configuration. Automates VPS creation, DNS management, NGINX configuration, security hardening, and system updates.

🌐 Now with Web Interface! Manage your VPS infrastructure through a beautiful web UI in addition to the powerful CLI.

Why?

Sick and tired of VPS configuration? The constant back-and-forth between different dashboards just to setup a VPS, then switching to SSH terminals, configuring NGINX, managing DNS records, setting up SSL certificates... It's exhausting and time-consuming.

Every single deployment meant:

Logging into the VPS provider dashboard
Spinning up a server
Switching to the domain registrar to configure DNS
SSH'ing into the server to install dependencies
Writing NGINX configs from scratch
Fighting with Let's Encrypt
Going back to SSH to check if everything works
Reading logs in the terminal to debug issues

Enough is enough. That's why I created this program - to automate all of this pain away and get back to actually building things instead of fighting with infrastructure.

VPSSetup vs Terraform vs Ansible

🎯 VPSSetup - The Simple Solution

Philosophy: "Just make it work, don't make me learn a new language"

Best for:

🚀 Solo developers and small teams
💡 Side projects and startups
⚡ Quick deployments (minutes, not hours)
🎨 People who want a nice UI, not YAML files

Key Differences:

Zero Learning Curve - Interactive CLI or web UI, no DSL to learn
Opinionated & Fast - Sensible defaults, get running in 5 minutes
All-in-One - VPS + DNS + NGINX + SSL + Deploy in one tool
Visual Interface - Beautiful web dashboard (Terraform/Ansible = terminal only)
Single Binary - No Python/Ruby dependencies, just download and run

🏗️ Terraform - Infrastructure as Code

Philosophy: "Declare your desired state, I'll figure out how to get there"

Best for:

🏢 Large enterprises
📊 Multi-cloud infrastructure
👥 Teams with dedicated DevOps
📝 Complex infrastructure requiring versioning

Key Differences:

Declarative DSL - You write HCL (HashiCorp Configuration Language)
State Management - Tracks infrastructure state, handles drift
Multi-Provider - AWS, Azure, GCP, DigitalOcean, 100+ providers
Steep Learning Curve - Need to learn HCL, modules, state management
Infrastructure Focus - Provisions resources, doesn't configure apps

🔧 Ansible - Configuration Management

Philosophy: "Tell me what to do, I'll do it on all servers"

Best for:

🏢 Enterprises managing 100+ servers
🔄 Configuration management at scale
👥 Teams with existing Ansible knowledge
🎭 Complex orchestration scenarios

Key Differences:

YAML Playbooks - You write playbooks describing tasks
Agentless - Uses SSH, no agent installation needed
Configuration Focus - Great for app config, not infrastructure provisioning
Steep Learning Curve - Roles, playbooks, inventory, Jinja2 templates
Python Dependency - Requires Python on control machine

📊 Quick Comparison Table

Feature	VPSSetup	Terraform	Ansible
Learning Time	5 minutes	Days/Weeks	Days/Weeks
Setup Time	Download & run	Install + learn HCL	Install Python + learn YAML
First Deploy	5 minutes	30-60 minutes	30-60 minutes
UI	✅ Web + CLI	❌ CLI only	❌ CLI only
DNS Integration	✅ Built-in	⚠️ Via providers	⚠️ Via modules
NGINX Config	✅ Interactive	❌ Manual	✅ Playbooks
SSL Certs	✅ Automatic	❌ Manual	✅ Playbooks
State Management	Config file	Remote state	Inventory
Best For	1-10 servers	10-1000+ servers	10-1000+ servers
Complexity	⭐ Simple	⭐⭐⭐⭐ Complex	⭐⭐⭐ Moderate

🤔 When to Use What?

Use VPSSetup when:

👤 You're a solo developer or small team
⚡ You want to deploy NOW, not after a week of learning
🎨 You prefer clicking buttons over writing YAML
💰 You manage < 10 servers
🚀 You want VPS + DNS + NGINX + SSL in one tool

Use Terraform when:

🏢 You need to manage 100+ resources across multiple clouds
📊 You need infrastructure versioning and team collaboration
🔄 You need to track and manage infrastructure drift
👥 You have dedicated DevOps team

Use Ansible when:

🏢 You need to manage configuration across 100+ servers
🔄 You need complex orchestration (blue-green deployments, etc.)
📦 You have existing Ansible playbooks/roles
👥 Your team already knows Ansible

Use Together (Yes, really!):

Terraform provisions infrastructure → VPSSetup configures single VPS
Ansible manages fleet → VPSSetup handles quick dev environments
Enterprise uses Terraform/Ansible → Developers use VPSSetup for personal projects

💡 Real World Example

VPSSetup:

./vpssetup web          # Open browser, click "Create VPS"
# 5 minutes later: Running website with SSL

Terraform:

# Write 50+ lines of HCL
resource "digitalocean_droplet" "web" { ... }
resource "digitalocean_firewall" "web" { ... }
# Learn state management, providers, modules
terraform init && terraform apply
# Then SSH and configure NGINX manually

Ansible:

# Write playbook (100+ lines)
- hosts: webservers
  roles: [nginx, ssl, firewall]
# Create inventory, variables, templates
ansible-playbook -i inventory deploy.yml

Features

✅ Implemented (All Phases Complete)

Phase 1 & 2: Infrastructure & Configuration

VPS Management - Create, destroy, restart, status, connect to VPS
SSH Key Management - Automatic SSH key generation and upload (with reuse detection)
Firewall Configuration - Automatic security rules for SSH, HTTP, HTTPS
System Updates - Automatic apt-get update & upgrade after VPS creation
Security Hardening - Automated fail2ban, UFW firewall, and SSH hardening
DNS Management - Full DNS record management (A, AAAA, CNAME, TXT, MX, NS, SRV) via sweb.ru API
NGINX Configuration - Automatic NGINX setup with support for static sites, reverse proxy, and PHP
SSL Certificates - Let's Encrypt integration for automatic HTTPS
Config Management - Profile-based YAML configuration with VPS info persistence
Interactive CLI - Beautiful, user-friendly prompts and progress indicators

Phase 3: Deployment & Monitoring

Deployment System - Three deployment strategies:
- Docker Compose - Full-stack apps with PostgreSQL, Redis, RabbitMQ
- Static Sites - HTML/CSS/JS with automatic NGINX configuration
- Standalone - Manual file upload for custom setups
SFTP Upload - Secure file transfer with automatic exclusions (.git, node_modules, etc.)
Logs Management - Fetch and view infrastructure logs:
- NGINX access/error logs
- System logs (syslog)
- fail2ban logs
- SSH authentication logs
- Firewall (UFW) logs
- Systemd service logs
Real Provider Data - Fetch available regions and sizes from DigitalOcean API

Phase 4: Web Interface ✨ NEW!

REST API - Complete HTTP API for all VPS operations
Web Dashboard - Beautiful gradient UI for managing infrastructure
VPS Management UI - Create, destroy, restart, harden VPS through browser
NGINX Configuration UI - Setup static sites, reverse proxies, and PHP apps
SSL Management UI - Install and renew Let's Encrypt certificates
Provider Integration - View available regions and instance sizes
Real-time Status - Live VPS status updates
Log Viewer - View and filter system logs

🚀 Future Enhancements

Multiple Providers - Support for AWS, Linode, Vultr, Hetzner
Rollback System - Restore previous deployment versions
Health Monitoring - Automated uptime checks and alerts
Backup Management - Automated VPS snapshots and restore

Prerequisites

Go 1.24+ (with toolchain 1.24.1)
DigitalOcean API token
sweb.ru account for DNS management (optional)

Installation

Build from Source

# Clone the repository
git clone https://github.com/Vova4o/VPSSetup.git
cd VPSSetup

# Build
go build -o bin/vpssetup ./cmd

# Or use make
make build

Quick Start

Option A: Web Interface 🌐

The easiest way to get started! Launch the web interface:

./bin/vpssetup web --port 8080

Then open your browser to http://localhost:8080

The web interface provides:

📊 Dashboard - VPS status and quick actions
🖥️ VPS Management - Create, restart, destroy, harden
🌐 NGINX Setup - Configure web servers (static, proxy, PHP)
🔒 SSL Management - Install and renew certificates
📝 Logs Viewer - View system and application logs

Option B: CLI (Command Line) ⌨️

For power users and automation:

1. Initialize Configuration

./bin/vpssetup init

This will:

Ask for your DigitalOcean API token
Optionally ask for DNS provider credentials (sweb.ru)
Generate SSH keys (or use existing ones)
Create a config.yaml file

2. Create a VPS

./bin/vpssetup setup

This will interactively:

Let you choose region (e.g., Toronto, NYC, San Francisco)
Let you choose instance size (e.g., $4/mo, $6/mo, $12/mo)
Ask for VPS name
Create the VPS with firewall configuration
Run system updates automatically (apt-get update & upgrade)
Save VPS info to config

3. Harden Security

./bin/vpssetup harden

This automatically:

Installs and configures fail2ban
Configures UFW firewall
Hardens SSH configuration (disable root login, key-only auth)
Sets up automatic security updates

4. Configure NGINX

./bin/vpssetup nginx setup

This interactively:

Installs NGINX on the VPS
Asks for domain name and configuration type (static/proxy/PHP)
Generates optimized NGINX configuration
Deploys and tests the configuration
Creates document root directories
Reloads NGINX with new settings

5. Manage DNS Records

# List all DNS records
./bin/vpssetup dns list

# Create a new DNS record (interactive)
./bin/vpssetup dns create

# Remove a DNS record (interactive)
./bin/vpssetup dns remove

Supported record types:

A - IPv4 address
AAAA - IPv6 address
CNAME - Canonical name
TXT - Text record
MX - Mail exchange
NS - Name server
SRV - Service record

6. Connect to VPS

./bin/vpssetup connect

Opens SSH connection to your VPS using the configured SSH key.

7. Restart VPS

./bin/vpssetup restart

Reboots the VPS via DigitalOcean API.

Command Reference

Web Interface Commands

Command	Description
`web`	Start web server (default port: 8080)

Options:

--port - Specify custom port (e.g., --port 3000)

Infrastructure Commands

Command	Description
`init`	Initialize configuration and API tokens
`setup`	Create and configure a new VPS
`connect`	SSH into the VPS
`restart`	Reboot the VPS
`harden`	Apply security hardening
`status`	Show VPS status and information
`destroy`	Destroy and delete VPS instance

NGINX Commands

Command	Description
`nginx setup`	Interactive NGINX configuration wizard
`nginx test`	Test NGINX configuration for errors
`nginx reload`	Reload NGINX to apply changes

DNS Commands

Command	Description
`dns list`	List all DNS records
`dns create`	Create a new DNS record
`dns remove`	Delete a DNS record

Deployment Commands

Command	Description
`upload`	Interactive deployment wizard (Docker/Static/Standalone)
`ssl install`	Install Let's Encrypt SSL certificate
`ssl renew`	Renew SSL certificate

Logs Commands

Command	Description
`logs nginx`	View NGINX access/error logs
`logs system`	View system logs (syslog)
`logs fail2ban`	View fail2ban logs
`logs ssh`	View SSH authentication logs
`logs firewall`	View UFW firewall logs
`logs service <name>`	View systemd service logs

Management Commands

Command	Description
`destroy`	Remove VPS and optionally clean config

Global Flags

-p, --profile <name> - Use specific profile
-c, --config <path> - Config file path (default: ./config.yaml)
-v, --verbose - Verbose output
--dry-run - Simulate actions without making changes

Examples

Complete Workflow

# 1. Initialize
./bin/vpssetup init

# 2. Create VPS
./bin/vpssetup setup
# Choose: Toronto, $6/mo droplet, name: "my-app"

# 3. Harden security
./bin/vpssetup harden

# 4. Configure NGINX
./bin/vpssetup nginx setup
# Type: proxy, Port: 3000, Domain: api.example.com

# 5. Configure DNS
./bin/vpssetup dns create
# Type: A, Name: api, Value: <your-vps-ip>

# 6. Connect to VPS
./bin/vpssetup connect

NGINX Configuration Examples

Static Website

./bin/vpssetup nginx setup
# Choose: static
# Domain: example.com
# Include www: yes
# Root path: /var/www/example.com/html
# SSL: no (configure later with certbot)

Reverse Proxy for Node.js/Go App

./bin/vpssetup nginx setup
# Choose: proxy
# Domain: api.example.com
# Include www: no
# Port: 3000
# SSL: no (configure later)

PHP Application

./bin/vpssetup nginx setup
# Choose: php
# Domain: blog.example.com
# Include www: yes
# Root path: /var/www/blog/public
# SSL: no

DNS Management Examples

# Create A record for subdomain
./bin/vpssetup dns create
# Choose: A, Enter: "api", Enter: "167.99.138.142"

# Create CNAME record
./bin/vpssetup dns create
# Choose: CNAME, Enter: "www", Enter: "example.com"

# Create TXT record for domain verification
./bin/vpssetup dns create
# Choose: TXT, Enter: "@", Enter: "google-site-verification=..."

# List all records
./bin/vpssetup dns list

# Remove a record (interactive selection)
./bin/vpssetup dns remove

Configuration

The tool uses a config.yaml file:

default_profile: default
profiles:
  default:
    vps:
      provider: digitalocean
      apitoken: your_do_token
      instanceid: "123456789"
      publicip: "192.0.2.1"
      name: my-vps
    ssh:
      keypath: ~/.ssh/vps_setup_key
      user: root
    domain:
      name: example.com
      dnsprovider: sweb.ru
      dnsapikey: your_sweb_token

Troubleshooting

SSH Connection Issues

If you can't connect to your VPS:

# Check VPS status
./bin/vpssetup status

# Verify SSH key
ls -la ~/.ssh/vps_setup_key*

# Try manual SSH connection
ssh -i ~/.ssh/vps_setup_key root@<vps-ip>

DNS Not Working

DNS propagation can take 5-15 minutes
Verify record was created: ./bin/vpssetup dns list
Check with dig: dig example.com
Ensure sweb.ru API token has proper permissions

NGINX Configuration Errors

# Test NGINX configuration
./bin/vpssetup nginx test

# Check NGINX logs on VPS
ssh root@<vps-ip>
sudo tail -f /var/log/nginx/error.log

# Reload NGINX after fixes
./bin/vpssetup nginx reload

Name		Name	Last commit message	Last commit date
api		api
bin		bin
cmd		cmd
internal		internal
pkg		pkg
tests		tests
web		web
.gitignore		.gitignore
AGENT.md		AGENT.md
IMPLEMENTATION.md		IMPLEMENTATION.md
Makefile		Makefile
NGINX_GUIDE.md		NGINX_GUIDE.md
README.md		README.md
SUBDOMAIN_EXAMPLE.md		SUBDOMAIN_EXAMPLE.md
TESTING.md		TESTING.md
go.mod		go.mod
go.sum		go.sum

Latest commit

History

Folders and files

Repository files navigation

VPSSetup - Automated VPS Deployment Tool

Why?

VPSSetup vs Terraform vs Ansible

🎯 VPSSetup - The Simple Solution

🏗️ Terraform - Infrastructure as Code

🔧 Ansible - Configuration Management

📊 Quick Comparison Table

🤔 When to Use What?

💡 Real World Example

Features

✅ Implemented (All Phases Complete)

Phase 1 & 2: Infrastructure & Configuration

Phase 3: Deployment & Monitoring

Phase 4: Web Interface ✨ NEW!

🚀 Future Enhancements

Prerequisites

Installation

Build from Source

Quick Start

Option A: Web Interface 🌐

Option B: CLI (Command Line) ⌨️

1. Initialize Configuration

2. Create a VPS

3. Harden Security

4. Configure NGINX

5. Manage DNS Records

6. Connect to VPS

7. Restart VPS

Command Reference

Web Interface Commands

Infrastructure Commands

NGINX Commands

DNS Commands

Deployment Commands

Logs Commands

Management Commands

Global Flags

Examples

Complete Workflow

NGINX Configuration Examples

Static Website

Reverse Proxy for Node.js/Go App

PHP Application

DNS Management Examples

Configuration

Troubleshooting

SSH Connection Issues

DNS Not Working

NGINX Configuration Errors

Roadmap

License

Author

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages