# #1 AWS Marketplace - Setup Guide Bookstack supports two authentication methods: standard and Google. # #1 AWS Marketplace - Setup Guide #### **Bookstack** supports two authentication methods: **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.
**Feature** **Standard Authentication** **Google Authentication (OIDC)**
**Login Method** Local username & password Google Single Sign-On (SSO)
**User Management** Managed within BookStack Users managed via Google Workspace
**Security Level** Standard password-based security OAuth 2.0 authentication with Google
**Ease of Use** Requires manual user management Seamless login with Google account
**Setup Complexity** No additional configuration required 🚨 **Requires a one-time login as the default admin** 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.
**Multi-Factor Authentication (MFA)** Not built-in, but can be configured Supports Google MFA
**Best For** Small teams, personal use Enterprises using Google services
**⚠ Important Notice!** At this time, BookStack **does not support simultaneous** use of both **Standard Authentication** and **Google Authentication (OIDC)**. To switch authentication methods, you must **manually update the `.env` file** and restart the BookStack docker container **(detailed instructions will be provided below)**. ### **📌 Deploying BookStack via AWS CloudFormation** #### Follow these steps to deploy **BookStack** in your AWS infrastructure: #### **1️⃣ Go to AWS Marketplace** 1\. Open the **BookStack** 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 **View purchase options**, in appeared page **Subscribe to this software** 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") **⚠ Important Notice!** We provide three **Fulfillment options**:
**Fulfillment option****Description****Architecture**
1. Bookstack infra without Cognito, default VPC, RDS AutoBackup Off, Single-AZ, EC2. ≈**$45.40****Cost-efficient** **BookStack** **deployment** 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.[Open Diagram](https://devsecopsinc-bookstack.s3.us-east-1.amazonaws.com/Diagram/Bookstack+infra-1.jpeg "diagram1.png")
2. Bookstack infra enabled Cognito, default VPC, RDS AutoBackup Off, Single-AZ, EC2. ≈**$51.40****Balanced BookStack** **deployment** 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.[Open Diagram](https://devsecopsinc-bookstack.s3.us-east-1.amazonaws.com/Diagram/Bookstack+infra-2.png "diagram2.png")
3. Bookstack infra enabled Cognito, new VPC, RDS AutoBackup Off, Single-AZ, EC2. ≈**$84.25****Optimized BookStack deployment** 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 [Open Diagram](https://devsecopsinc-bookstack.s3.us-east-1.amazonaws.com/Diagram/Bookstack+infra-3.png "diagram3.png")
#### **2️⃣ Deployment via CloudFormation** **📌 Choosing Parameters** 1\. You will be redirected to **CloudFormation Stack Launch** 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") 2. Specify stack details. Here, you need to fill in the `Stack name`. You can choose **any name** for your stack, but we recommend using a structured format like: `bookstack` (e.g., `wiki`, `docs`, etc.). For this guide, we will use **wiki** 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")