This repository contains ready-to-use Terraform templates to help you provision and deploy your SimpleNS (Simple Notification System) instance to various cloud providers directly from your terminal.
Currently, we support the following cloud providers:
- AWS (Amazon Web Services) - Provision an EC2 instance with Amazon Linux 2023, properly configured security groups, and an automated deployment script.
More cloud provider templates (like DigitalOcean, GCP, Azure, etc.) will be added in the future.
Each template folder contains a standalone Terraform configuration designed to bootstrap a fresh virtual machine. During the provisioning process, the instances use cloud-init user-data scripts to automatically:
- Update system packages.
- Install Docker and Docker Compose.
- Install Node.js setup dependencies.
- Execute the
@simplens/onboardCLI tool. - Bootstrap the entire SimpleNS stack (including infrastructure like MongoDB, Redis, Kafka, Loki, Grafana, etc.).
By using these templates, you can go from an empty terminal to a fully running, production-ready SimpleNS instance in under 10 minutes.
To use any of the templates in this repository, you'll generally need:
- Terraform: Make sure Terraform (
>= 1.0.0) is installed on your machine. - Cloud Provider Credentials: Administrative or programmatic access to your chosen cloud provider (e.g., AWS CLI configured with Access Keys).
- SSH Keys: An existing SSH key pair in your target environment to remotely access the provisioned servers.
Please refer to the specific README.md inside each provider's folder for detailed, step-by-step usage instructions.