📌 Configuring Parameters for main stack
Step 1. Prerequisite - Prepare template
Choose an existing template→Specify template→Amazon S3 URL→ here paste the URL template https://devsecopsinc-bookstack.s3.us-east-1.amazonaws.com/main-template.yml. And click Next button.
Follow these steps:
1. Enter the Deployment Environment (e.g., dev, prod).
2. Specify the AppURL – the URL where BookStack will be accessible.
3. If using Cognito for authentication, provide your Google OAuth Client ID / Secret.
4. Choose:
• EC2 instance type (t4g.small is recommended for small environments).
• RDS instance type (db.t4g.small is the default).
• RDS storage size (20 GB by default).
• Multi-AZ deployment (set to false for cost efficiency).
• Enable/Disable RDS backups.
1️⃣ Launching the CloudFormation Stack
1. Click Next and review your configuration.
2. On the next page, check the box for I acknowledge that AWS CloudFormation might create IAM resources with custom names.
3. Click Create stack.
2️⃣ Retrieving the Access URL
1. After successful deployment, navigate to the Outputs tab in CloudFormation.
2. Locate AppURL → this is your final BookStack access URL.
3. If using a custom domain, create a CNAME record in your DNS registrar, pointing AppURL to LoadBalancerDNSName.
3️⃣ Accessing BookStack
1. Open AppURL in your browser.
2. Log in using the default credentials:
• Username: admin@admin.com
• Password: password
3. Change your password immediately! You can do this under Profile → Settings.
Additional Information
✅ Application logs are available in CloudWatch Logs.
✅ Data is stored in RDS, while Bookstack files are stored on Amazon EFS.
✅ Deletion: If needed, delete the main CloudFormation Stack to remove all associated resources automatically. ⚠ Important Notice! Before proceeding, navigate to AWS Backup → Vaults → your-backup-vault-name → Recovery Points. Select all recovery points, click the Action button, and choose Delete. This will remove all EFS backups.
Otherwise, deleting the CloudFormation stack will result in an error.