# 📌 2. Configuring Parameters for main stack

### **<span class="awsui_heading-text_2qdw9_1ok6e_398 awsui_heading-text_105ke_268sp_5 awsui_heading-text-variant-h2_2qdw9_1ok6e_409" data-analytics-funnel-key="substep-name" id="bkmrk-step-1.-prerequisite-1">Step 1. Prerequisite - Prepare template</span>**

<span class="awsui_heading-text_2qdw9_1ok6e_398 awsui_heading-text_105ke_268sp_5 awsui_heading-text-variant-h2_2qdw9_1ok6e_409" data-analytics-funnel-key="substep-name">We did the first step previously, when subscribed for the product in [AWS Marketplace - Setup Guide](https://wiki.devsecopsinc.io/books/install-bookstack-wiki/page/1-aws-marketplace-setup-guide#bkmrk-2%EF%B8%8F%E2%83%A3-deployment-via-c "Deployment via CloudFormation"), so move forward to the next step.</span>

[![2.1. Deploy.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/2-1-deploy.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/2-1-deploy.png "step-1.png")

### **Step 2. Specify stack details**

Here, you need to fill in the `Stack name`. You can choose <span class="s1">**any name**</span> for your stack, but we recommend using a structured format like: `<span class="s1"><strong>bookstack</strong></span>`<span class="s2"> (e.g., </span>`wiki`<span class="s2">, </span>`docs`<span class="s2">, etc.). </span>

For this guide, we will use <span class="s1">**wiki**</span> as an example.

[![4-Step 2 Name.jpeg](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/4-step-2-name.jpeg)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/4-step-2-name.jpeg "4-step-2-name.jpeg")

There are **21 parameters,** some of which are predefined. You don’t need to fill in all of them — just focus on the **required** and **empty fields**. For additional guidance, refer to the help description provided under each parameter.

[![4-step-2-parameters.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/4-step-2-parameters.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/4-step-2-parameters.png "4-step-2-parameters.png")

<span class="s2"><span style="color: rgb(224, 62, 45);">**⚠ Important Notice!**</span>: There are </span>three <span class="s2">additional parameters for **AWS Marketplace Store**. They are starting from prefixes as "**MPS"**, so you shouldn't modify them - otherwise, CloudFormation will fail with an error.</span>

[![4-step-2-MPS-parameters-new.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/4-step-2-mps-parameters-new.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/4-step-2-mps-parameters-new.png "4-step-2-mps-parameters-new.png")

##### **7 Required Parameters:**

1\. **Deployment** **Environment** – Specify the environment (e.g., `<span class="s3">dev</span>`, `<span class="s3">prod</span>`).

2\. For **optional** **parameters**, you can leave the string blank, as we did with `CostAllocationTag`, `GoogleClientId`, `GoogleClientSecret`.

3\. <span class="s1">**AppURL**</span> – Define the URL where BookStack will be accessible.

4\. **VPC** **ID** – Enter the ID of an existing VPC.

5\. **VPC** **CIDR** **block** – Provide the CIDR block of your existing VPC**.**

6\. **Subnet** **IDs** – Enter the IDs of your existing subnets (e.g., `Subnet 1 ID`, `Subnet 2 ID`).

[![4-2 Step 2 Parameters.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/4-2-step-2-parameters.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/4-2-step-2-parameters.png "4-2-step-2-parameters.png")

<span class="s2"><span style="color: rgb(224, 62, 45);">**⚠ Important Notice!**</span>:</span> If you want to create new VPC, you should fill ONLY the `VPC CIDR Block`.

[![4-2 Step 2 Parameters-addition.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/4-2-step-2-parameters-addition.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/4-2-step-2-parameters-addition.png "4-2-step-2-parameters-addition.png")

7\. **EnableUserSignUp**, **MultipleAuthMethods** - by default set to false for best security practices.

[![cognito-params.jpeg](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/cognito-params.jpeg)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/cognito-params.jpeg "cognito-params.jpeg")

8\. **SSL Certificate ARN** – Provide the ARN of your SSL Certificate for the ALB. (*If you don’t have one, you must create it*.)

[![4-3 Step 2 Parameters.jpeg](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/4-3-step-2-parameters.jpeg)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/4-3-step-2-parameters.jpeg "4-3-step-2-parameters.jpeg")

<span class="s2"><span style="color: rgb(224, 62, 45);">**⚠ Important Notice!**</span>: There is </span>one <span class="s2">required parameter for **EC2AMI**. Its value is set to "**`/aws/service/marketplace/prod-ymfbr3id36e3k/version-v1.0-bookstack-v24.05.4`"**, so you shouldn't modify it - otherwise, CloudFormation will fail with an error. </span>

[![4-3 Step 2 EC2Parameters-new.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/4-3-step-2-ec2parameters-new.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/4-3-step-2-ec2parameters-new.png "4-3-step-2-ec2parameters-new.png")

##### **Override Optional Parameters**

Some parameters have predefined default values. You can **modify** them as needed or **leave them unchanged**:

• <span class="s1">**EC2 instance type**</span> (`<span class="s3">t4g.small</span>` is the default and is recommended for small environments).

• <span class="s1">**RDS DB instance type**</span> (`<span class="s3">db.t4g.small</span>` is the default).

• <span class="s1">**RDS storage size**</span> (`<span class="s3">20 GB</span>` by default).

• <span class="s1">**Multi-AZ deployment**</span> (set to `<span class="s3">false</span>` for cost efficiency).

<span class="s2"> • </span>**Enable/Disable RDS backups**<span class="s2">.</span>

<span class="s2">• **Enable/Disable RDS deletion protection**. <span style="color: rgb(224, 62, 45);">**⚠ Important Notice!**</span>: **<span style="color: rgb(224, 62, 45);">If</span>** this **<span style="color: rgb(224, 62, 45);">parameter</span>** is **<span style="color: rgb(224, 62, 45);">enabled</span>**, <span style="color: rgb(224, 62, 45);">**you** **will** **not** **be able to delete the stack**</span>. To proceed with deletion, go to `AWS Console` → `Amazon RDS` → `Databases`, select your database, click **Modify**, and uncheck "**Enable deletion protection**" for `bookstack-dev-rds`. After this, you can delete the main stack in CloudFormation.</span>

<span class="s2">• **Schedule backup rules**.</span>

<span class="s2">• **Schedule backup deletion**.</span>

### **Step 3. Configure stack options** 

Scroll to the bottom, check both checkboxes in the Capabilities field, and click the Next button.

[![5-Step 3 Capabilities 2.jpeg](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/5-step-3-capabilities-2.jpeg)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/5-step-3-capabilities-2.jpeg "5-step-3-capabilities-2.jpeg")

### **Step 4. Review and create**

Scroll to the bottom and click the **<span style="color: rgb(0, 0, 0); background-color: rgb(230, 126, 35);">Submit</span>** button.

[![6-Step 4 Submit.jpeg](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/6-step-4-submit.jpeg)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/6-step-4-submit.jpeg "6-step-4-submit.jpeg")

Now you can see how your environment is being deployed.

[![7-Step 4 Deploying.jpeg](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/7-step-4-deploying.jpeg)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/7-step-4-deploying.jpeg "7-step-4-deploying.jpeg")

### **Follow these simple steps to access your product:**

#### **1️⃣ Retrieving the Access URL**

1\. After successful deployment, your product will be available at a generated URL, which can be found in the `bookstack-$Environment-main` stack under the **Outputs** section, **key** `LoadBalancerDNSName`, **key** `AppURL`.

2\. In your domain registrar, create a **CNAME** **record** for `AppURL`, pointing to the generated `LoadBalancerDNSName`.

3\. Open **AppURL** in your browser and enjoy!

[![7-Outputs.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/7-outputs.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/7-outputs.png "7-outputs.png")

#### **2️⃣ Accessing BookStack**

1\. Open **<span class="s3">AppURL</span>** in your browser.

2\. Log in using the <span class="s1">**default credentials**</span>:

<span class="s2"> • </span><span class="s1">**Username:**</span> `admin@admin.com`

<span class="s2"> • </span>**Password:** `<span class="s3">password</span>`

<span class="s2"> 3. </span>**Change your password immediately!**<span class="s2"> You can do this under </span>**Profile → Settings**<span class="s2">.</span>

[![8-Login.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/8-login.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/8-login.png "8-login.png")

##### **Additional Information**

<span class="s1">✅ </span>**Application logs**<span class="s1"> are available in </span>**CloudWatch Logs**<span class="s1">.</span>

✅ <span class="s2">**Data is stored in RDS**</span>, while Bookstack files are stored on Amazon<span class="s2"> **EFS**</span>.

✅ <span class="s2">**Deletion**</span>: If needed, delete the main CloudFormation Stack to remove all associated resources automatically.

<span style="color: rgb(224, 62, 45);">**⚠ Important Notice!**</span> Before proceeding, navigate to <span style="background-color: rgb(0, 0, 0); color: rgb(236, 240, 241);">**AWS Backup → Vaults → your-backup-vault-name → Recovery Points**</span>. Select all recovery points, click the **Actions** button, and choose **Delete**. This will remove all **EFS backups**.  
**<span style="color: rgb(224, 62, 45);">Otherwise, deleting the CloudFormation stack will result in an error</span>**.[![Bookstack-aws-backup.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/bookstack-aws-backup.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/bookstack-aws-backup.png "bookstack-aws-backup.png")

[![vault recovery points.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/scaled-1680-/vault-recovery-points.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-03/vault-recovery-points.png "vault-recovery-points.png")

###  

### <span class="s1">ℹ️ </span>**Additional Information:**

> Some minor issues may occur during the initial launch, which are known and documented. Please visit the [BookStack Bugs and Known Issues](https://wiki.devsecopsinc.io/books/bookstack-known-issues) section for more information.