Overview
This AMI deploys SonarQube using Docker Compose with automated configuration for a secure and seamless code quality analysis setup. Designed for production environments, it includes: Automatic SonarQube container deployment using Docker Compose First-time guided configuration for custom domain, DNS validation, and SSL setup via Certbot Auto-generated strong admin credentials stored securely in .env Pre-configured SonarQube web dashboard for project management and analysis Persistent data volumes to ensure analysis data durability Apache/Nginx reverse proxy for HTTPS-secured access Built-in failsafe installer that ensures setup completion successfully
Highlights
- Production-ready & Secure: SSL-enabled access with automated domain configuration and certificate provisioning
- Fully Automated Setup: Failsafe installer ensures SonarQube deployment always completes successfully
- Complete Web Dashboard: Full SonarQube UI for managing projects, viewing code quality metrics, and enforcing quality gates
Details
Introducing multi-product solutions
You can now purchase comprehensive solutions tailored to use cases and industries.
Features and programs
Financing for AWS Marketplace purchases
Pricing
- ...
Dimension | Cost/hour |
|---|---|
t2.medium Recommended | $0.05 |
t3.micro | $0.05 |
m7i.16xlarge | $0.05 |
m6idn.large | $0.05 |
inf1.2xlarge | $0.05 |
m8i.48xlarge | $0.05 |
c3.2xlarge | $0.05 |
x1.32xlarge | $0.05 |
c7i.metal-48xl | $0.05 |
m5d.24xlarge | $0.05 |
Vendor refund policy
For any questions or concern, please contact: Perimattic.com Email: aws-support@perimattic.comÂ
How can we make this page better?
Legal
Vendor terms and conditions
Content disclaimer
Delivery details
64-bit (x86) Amazon Machine Image (AMI)
Amazon Machine Image (AMI)
An AMI is a virtual image that provides the information required to launch an instance. Amazon EC2 (Elastic Compute Cloud) instances are virtual servers on which you can run your applications and workloads, offering varying combinations of CPU, memory, storage, and networking resources. You can launch as many instances from as many different AMIs as you need.
Version release notes
-
Added automated first-boot provisioning using failsafe.sh to guarantee complete and reliable SonarQube installation.
-
Implemented secure SonarQube setup with auto-generated admin credentials stored safely inside the .env file.
-
Added mandatory domain validation workflow with guided prompts during first boot.
-
Fully automated SSL certificate provisioning using Certbot with Apache/Nginx reverse proxy integration.
-
Enabled SonarQube Web Dashboard with secure HTTPS routing for code quality and vulnerability analysis.
-
Delivered Docker Compose-based deployment for consistent, reproducible production environments.
-
Configured persistent data volumes to ensure SonarQube project data, plugins, and logs remain intact across reboots.
-
Added auto-restart policies for SonarQube and database containers to improve reliability and uptime.
-
Enhanced DNS validation logic to prevent SSL certificate failures during domain mapping.
-
Integrated a self-healing installer that retries failed steps to guarantee successful provisioning even after interruptions.
Additional details
Usage instructions
1.Launch an Instance
From AWS Marketplace, select Continue to Subscribe, then Continue to Configuration, and launch the AMI into your preferred VPC and subnet.
2.Choose the Recommended Instance Type
Select t2.medium or larger for smooth SonarQube operation.
SonarQube and PostgreSQL require adequate CPU and RAM.
For CI/CD or teams of 5 or more developers, consider t3.medium or t3.large.
3.Configure Security Group
Allow inbound access on these ports:
22 - SSH access 80 - Required temporarily for SSL validation 443 - Secure HTTPS access to SonarQube
These ports are required for first-boot automation, certificate generation, and dashboard access.
4.Connect to the Instance
SSH into your server:
ssh -i <your-key.pem> ubuntu@<public-ip>
The automated first-boot setup will begin immediately after login.
5.First-Boot Setup (Interactive Guided Installation)
On first connection, an automated installer will:
Detect your public IP
Ask for your domain name for SonarQube
Validate DNS A-record mapping
Ask for admin email for SSL certificates
Generate secure SonarQube admin passwords
Save all credentials securely inside: /opt/app/.env
Configure Apache reverse proxy for HTTPS
Request and install a free Let's Encrypt SSL certificate
Deploy SonarQube and PostgreSQL using Docker Compose
Display your secure login URL and credentials upon completion
Setup is handled by: firstboot.sh, setup.sh, and failsafe.sh
6.DNS Configuration Required
Before or during setup, add this DNS A-record:
yourdomain.com -> <your-instance-public-IP>
The installer continues automatically once DNS is propagated.
7.Automatic SSL Setup
After DNS is verified:
A Let's Encrypt SSL certificate is issued
Apache is automatically configured for HTTPS
HTTP to HTTPS redirects are enabled
Secure dashboard access is activated
8.Start or Restart SonarQube Manually
cd /opt/app docker compose ps docker compose restart
Persistent Docker volumes ensure SonarQube data, logs, and plugins survive restarts.
9.Access the SonarQube Dashboard
Open in your browser:
https://<your-domain>
Credentials are displayed after installation and saved in:
/opt/app/.env /opt/app/admin_password.txt
Default username: admin
Password: Auto-generated during setup.
10.Retrieve Credentials Anytime
cat /opt/app/.env cat /opt/app/admin_password.txt
Both files store the admin password generated during first-boot provisioning.
Support
Vendor support
For any assistance or inquiries, our dedicated support team is here to help 24/7. Feel free to reach out to us anytime. Email: aws@perimattic.com We are committed to providing timely and effective solutions to meet your needs.
AWS infrastructure support
AWS Support is a one-on-one, fast-response support channel that is staffed 24x7x365 with experienced and technical support engineers. The service helps customers of all sizes and technical abilities to successfully utilize the products and features provided by Amazon Web Services.