[FEATURE] Create a base ansible playbook for node setup #8

New issue

Open

opened 2026-07-07 10:50:48 +00:00 by PoweredDeveloper · 0 comments

PoweredDeveloper commented

2026-07-07 10:50:48 +00:00

Owner

Is your feature request related to a problem?
Setting up a new VPN node currently requires manual installation and configuration. This process makes it difficult to deploy multiple nodes consistently.

Describe the solution you'd like
Create a reusable Ansible playbook that performs the initial provisioning of a VPN node. The playbook should:

Update the operating system and install required packages.
Configure basic system settings (timezone, firewall, SSH, etc.).
Prepare the directory structure for the VPN stack.
Deploy and configure 3x-UI (or the selected VPN management service) via installer 3x-UI installer.
Be idempotent so it can be safely executed multiple times.

This will provide a consistent, automated, and repeatable deployment process for all VPN nodes.

Describe alternatives you've considered

Manual server setup using SSH.

Additional context
This playbook serves as the foundation for future infrastructure automation. Additional roles (monitoring, backups, node registration, updates, etc.) can be added in later iterations as well as support for configuration through Ansible variables for different environments.

Checklist

I have checked that this feature is not already requested.
I am willing to help implement it (optional).

**Is your feature request related to a problem?** Setting up a new VPN node currently requires manual installation and configuration. This process makes it difficult to deploy multiple nodes consistently. **Describe the solution you'd like** Create a reusable Ansible playbook that performs the initial provisioning of a VPN node. The playbook should: * Update the operating system and install required packages. * Configure basic system settings (timezone, firewall, SSH, etc.). * Prepare the directory structure for the VPN stack. * Deploy and configure 3x-UI (or the selected VPN management service) via installer [3x-UI installer](https://docs.sanaei.dev/docs/guide/installation/). * Be idempotent so it can be safely executed multiple times. This will provide a consistent, automated, and repeatable deployment process for all VPN nodes. **Describe alternatives you've considered** * Manual server setup using SSH. **Additional context** This playbook serves as the foundation for future infrastructure automation. Additional roles (monitoring, backups, node registration, updates, etc.) can be added in later iterations as well as support for configuration through Ansible variables for different environments. **Checklist** * [x] I have checked that this feature is not already requested. * [x] I am willing to help implement it (optional).

PoweredDeveloper added this to the Sprint 1 milestone

2026-07-07 10:50:48 +00:00

PoweredDeveloper added the

enhancement

label

2026-07-07 10:50:48 +00:00

PoweredDeveloper self-assigned this

2026-07-07 10:50:48 +00:00

PoweredDeveloper added this to the Infrastructure project

2026-07-07 10:50:48 +00:00

PoweredDeveloper changed reference from ~~main~~ to insfrastructure

2026-07-07 10:50:50 +00:00