# #1 AWS Marketplace - Setup Guide

#### **Bookstack** supports two <span style="text-decoration: underline;">authentication</span> <span style="text-decoration: underline;">methods</span>: **standard** and **Google**.

The following table compares the two methods. Choose the one that best fits your needs and click the “**Go to AWS Marketplace**” button.

<table border="1" id="bkmrk-feature-standard-aut" style="border-collapse: collapse; width: 100%; height: 238.4px;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Feature**

</td><td style="height: 29.8px;">**Standard Authentication**

</td><td style="height: 29.8px;">**Google Authentication (OIDC)**

</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">**Login Method**

</td><td style="height: 29.8px;">Local username &amp; password

</td><td style="height: 29.8px;">Google Single Sign-On (SSO)

</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">**User Management**

</td><td style="height: 29.8px;">Managed within BookStack

</td><td style="height: 29.8px;">Users managed via Google Workspace

</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">**Security Level**

</td><td style="height: 29.8px;">Standard password-based security

</td><td style="height: 29.8px;">OAuth 2.0 authentication with Google

</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">**Ease of Use**

</td><td style="height: 29.8px;">Requires manual user management

</td><td style="height: 29.8px;">Seamless login with Google account

</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">**Setup Complexity**

</td><td style="height: 29.8px;">No additional configuration required

</td><td style="height: 29.8px;">🚨 <span class="s1">**Requires a one-time login as the default admin**</span> to grant admin privileges to your **Cognito** account. By default, **Cognito**-**authenticated** users are assigned the **Viewer** **role**, and this step ensures that your account receives **Admin** permissions.

</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">**Multi-Factor Authentication (MFA)**

</td><td style="height: 29.8px;">Not built-in, but can be configured

</td><td style="height: 29.8px;">Supports Google MFA

</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">**Best For**

</td><td style="height: 29.8px;">Small teams, personal use

</td><td style="height: 29.8px;">Enterprises using Google services

</td></tr></tbody></table>

<span style="color: rgb(224, 62, 45);">**⚠ Important Notice!** </span><span class="s1">At this time, BookStack </span>**does not support simultaneous**<span class="s1"> use of both </span>**Standard Authentication**<span class="s1"> and </span>**Google Authentication (OIDC)**<span class="s1">.</span>

To switch authentication methods, you must <span class="s2">**manually update the `.env` file**</span> and restart the BookStack docker container **(detailed instructions will be provided below)**.

### **📌 Deploying BookStack via AWS CloudFormation**

#### Follow these steps to deploy <span class="s1">**BookStack**</span> in your AWS infrastructure:

#### **1️⃣ Go to AWS Marketplace**

1\. Open the <span class="s1">**BookStack**</span> page directly on [AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-usp3j2un3twza?sr=0-1&ref_=beagle&applicationId=AWSMPContessa "Bookstack Wiki Software") - or type the name of the product `Bookstack Wiki Software`.

2\. Click **<span style="background-color: rgb(230, 126, 35); color: rgb(0, 0, 0);">View purchase options</span>**, in appeared page <span style="color: rgb(22, 145, 121);">**Subscribe to this software**</span> review the terms, pricing information and accept the agreement.

[![View purchase options.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/view-purchase-options.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/view-purchase-options.png "view-purchase-options.png")

[![2. Accept the terms.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/2-accept-the-terms.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/2-accept-the-terms.png "2-accept-the-terms.png")

3\. The subscription is now `Pending`.

[![3. Pending.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/3-pending.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/3-pending.png "3-pending.png")

4\. Wait until the subscription is active and click on **Continue to Configuration**.

[![4. Continue to configuration.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/4-continue-to-configuration.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/4-continue-to-configuration.png "4-continue-to-configuration.png")

5\. Continue with selecting fulfillment option, version, and region.

[![5. Continue to launch.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/5-continue-to-launch.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/5-continue-to-launch.png "5-continue-to-launch.png")

6\. **Launch**. Here, you can read the manual or launch your own wiki.

[![6. Launch.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/6-launch.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/6-launch.png "6-launch.png")

<span style="color: rgb(224, 62, 45);">**⚠ Important Notice!**</span> We provide three **Fulfillment options**:

<table border="1" id="bkmrk-fulfillment-option-d" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col></colgroup><tbody><tr><td>**Fulfillment option**</td><td>**Description**</td><td>**Architecture**</td></tr><tr><td>1. Bookstack infra without Cognito, default VPC, RDS AutoBackup Off, Single-AZ, EC2. ≈<span style="text-decoration: underline;">**$45.40**</span></td><td><span style="text-decoration: underline;">**Cost-efficient**</span> **BookStack** <span style="text-decoration: underline;">**deployment**</span> utilizing an **existing VPC** and **RDS Single-AZ**. **AWS Cognito** is excluded, but the setup retains **EFS Backup**, **Secrets Manager**, **Systems Manager**, **EC2**, and **CloudWatch Logs** for security and monitoring.</td><td>[Open Diagram](https://devsecopsinc-bookstack.s3.us-east-1.amazonaws.com/Diagram/Bookstack+infra-1.jpeg "diagram1.png")</td></tr><tr><td>2. Bookstack infra enabled Cognito, default VPC, RDS AutoBackup Off, Single-AZ, EC2. ≈<span style="text-decoration: underline;">**$51.40**</span></td><td><span style="text-decoration: underline;">**Balanced BookStack** **deployment**</span> utilizing an **existing VPC** with **AWS** **Cognito** for **authentication**. **RDS** **Single-AZ** with **AutoBackup** **disabled** ensures cost efficiency, while **EFS** **Backup**, **Secrets Manager**, **Systems Manager**, **EC2**, and **CloudWatch Logs** provide security and monitoring.</td><td>[Open Diagram](https://devsecopsinc-bookstack.s3.us-east-1.amazonaws.com/Diagram/Bookstack+infra-2.png "diagram2.png")</td></tr><tr><td>3. Bookstack infra enabled Cognito, new VPC, RDS AutoBackup Off, Single-AZ, EC2. ≈<span style="text-decoration: underline;">**$84.25**</span></td><td><span style="text-decoration: underline;">**Optimized BookStack deployment**</span> with **Cognito** **authentication**, **new VPC**, and **RDS Single-AZ**. Includes **EC2 instance**, **EFS Backup**, **Secrets Manager**, **Systems Manager**, and **CloudWatch** **Logs** for enhanced security, scalability, and monitoring

</td><td>[Open Diagram](https://devsecopsinc-bookstack.s3.us-east-1.amazonaws.com/Diagram/Bookstack+infra-3.png "diagram3.png")</td></tr></tbody></table>

#### **2️⃣ Deployment via CloudFormation**

**📌 Choosing Parameters**

1\. You will be redirected to <span class="s1">**CloudFormation Stack Launch**</span> with selected AWS region where you want to deploy BookStack. Click **Next**.

[![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 "2-1-deploy.png")

<span class="s2"> 2. Specify stack details</span>. Here, you need to fill in the `Stack name`. You can choose <span class="s1" style="box-sizing: border-box; outline-color: var(--color-primary); outline-width: 1px; margin: 0px; padding: 0px; border: 0px; font-style: inherit; font-variant-caps: inherit; font-weight: inherit; font-width: inherit; font-size: inherit; line-height: inherit; font-family: inherit; font-size-adjust: inherit; font-kerning: inherit; font-variant-alternates: inherit; font-variant-ligatures: inherit; font-variant-numeric: inherit; font-variant-east-asian: inherit; font-variant-position: inherit; font-variant-emoji: inherit; font-feature-settings: inherit; font-optical-sizing: inherit; font-variation-settings: inherit; vertical-align: baseline;">**any name**</span> for your stack, but we recommend using a structured format like: `<span class="s1" style="box-sizing: border-box; outline-color: var(--color-primary); outline-width: 1px; margin: 0px; padding: 0px; border: 0px; font-style: inherit; font-variant-caps: inherit; font-weight: inherit; font-width: inherit; font-size: inherit; line-height: inherit; font-family: inherit; font-size-adjust: inherit; font-kerning: inherit; font-variant-alternates: inherit; font-variant-ligatures: inherit; font-variant-numeric: inherit; font-variant-east-asian: inherit; font-variant-position: inherit; font-variant-emoji: inherit; font-feature-settings: inherit; font-optical-sizing: inherit; font-variation-settings: inherit; vertical-align: baseline;"><strong style="box-sizing: border-box; outline-color: var(--color-primary); outline-width: 1px; margin: 0px; padding: 0px; border: 0px; font-style: inherit; font-variant-caps: inherit; font-weight: bold; font-width: inherit; font-size: inherit; line-height: inherit; font-family: inherit; font-size-adjust: inherit; font-kerning: inherit; font-variant-alternates: inherit; font-variant-ligatures: inherit; font-variant-numeric: inherit; font-variant-east-asian: inherit; font-variant-position: inherit; font-variant-emoji: inherit; font-feature-settings: inherit; font-optical-sizing: inherit; font-variation-settings: inherit; vertical-align: baseline;">bookstack</strong></span>`<span class="s2" style="box-sizing: border-box; outline-color: var(--color-primary); outline-width: 1px; margin: 0px; padding: 0px; border: 0px; font-style: inherit; font-variant-caps: inherit; font-weight: inherit; font-width: inherit; font-size: inherit; line-height: inherit; font-family: inherit; font-size-adjust: inherit; font-kerning: inherit; font-variant-alternates: inherit; font-variant-ligatures: inherit; font-variant-numeric: inherit; font-variant-east-asian: inherit; font-variant-position: inherit; font-variant-emoji: inherit; font-feature-settings: inherit; font-optical-sizing: inherit; font-variation-settings: inherit; vertical-align: baseline;"> (e.g., </span>`wiki`<span class="s2" style="box-sizing: border-box; outline-color: var(--color-primary); outline-width: 1px; margin: 0px; padding: 0px; border: 0px; font-style: inherit; font-variant-caps: inherit; font-weight: inherit; font-width: inherit; font-size: inherit; line-height: inherit; font-family: inherit; font-size-adjust: inherit; font-kerning: inherit; font-variant-alternates: inherit; font-variant-ligatures: inherit; font-variant-numeric: inherit; font-variant-east-asian: inherit; font-variant-position: inherit; font-variant-emoji: inherit; font-feature-settings: inherit; font-optical-sizing: inherit; font-variation-settings: inherit; vertical-align: baseline;">, </span>`docs`<span class="s2" style="box-sizing: border-box; outline-color: var(--color-primary); outline-width: 1px; margin: 0px; padding: 0px; border: 0px; font-style: inherit; font-variant-caps: inherit; font-weight: inherit; font-width: inherit; font-size: inherit; line-height: inherit; font-family: inherit; font-size-adjust: inherit; font-kerning: inherit; font-variant-alternates: inherit; font-variant-ligatures: inherit; font-variant-numeric: inherit; font-variant-east-asian: inherit; font-variant-position: inherit; font-variant-emoji: inherit; font-feature-settings: inherit; font-optical-sizing: inherit; font-variation-settings: inherit; vertical-align: baseline;">, etc.). </span>

For this guide, we will use <span class="s1" style="box-sizing: border-box; outline-color: var(--color-primary); outline-width: 1px; margin: 0px; padding: 0px; border: 0px; font-style: inherit; font-variant-caps: inherit; font-weight: inherit; font-width: inherit; font-size: inherit; line-height: inherit; font-family: inherit; font-size-adjust: inherit; font-kerning: inherit; font-variant-alternates: inherit; font-variant-ligatures: inherit; font-variant-numeric: inherit; font-variant-east-asian: inherit; font-variant-position: inherit; font-variant-emoji: inherit; font-feature-settings: inherit; font-optical-sizing: inherit; font-variation-settings: inherit; vertical-align: baseline;">**wiki**</span> as an example.

[![2.2. Specify stack details.png](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/scaled-1680-/2-2-specify-stack-details.png)](https://wiki.devsecopsinc.io/uploads/images/gallery/2025-04/2-2-specify-stack-details.png)

To proceed, please follow this instruction: [2. Configuring Parameters for main stack](https://wiki.devsecopsinc.io/books/install-bookstack-wiki/page/2-configuring-parameters-for-main-stack "wiki.devsecopsinc.io")