SurfImaging.ai logo

AWS SurfViewer Quick Start

Follow this quick start guide to subscribe to SurfViewer from AWS Marketplace, complete Quick Launch, and continue with administrator onboarding and ingestion.

Back to AWS Landing Page Contact SurfImaging Support

Prerequisites

Use an AWS account with permission to subscribe in AWS Marketplace. If you do not already have an AWS account, you can start with an AWS Free Tier account.
Make sure you can subscribe in AWS Marketplace and create CloudFormation stacks in the target region, typically us-east-1.
For a broader overview of AWS prerequisites and launch guidance, see the AWS landing page prerequisites.
1
Marketplace

Find SurfViewer in AWS Marketplace

  1. Open AWS Marketplace and locate the SurfViewer offer.
  2. Review the product page to confirm you are working with the correct listing.
  3. Open the offer to continue into purchase options.
SurfViewer listing in AWS Marketplace
SurfViewer listed in AWS Marketplace.
2
Marketplace

Review the purchase options

  1. Open the purchase options for the SurfViewer offer.
  2. Review the AWS Marketplace message that the product subscription is free of charge, has no end date, and can be canceled at any time.
  3. Note that separate AWS infrastructure costs may still apply to the resources deployed in your account.
  4. Subscribe.
SurfViewer purchase options in AWS Marketplace
Review the SurfViewer purchase options and note that AWS infrastructure charges may still apply.
3
Marketplace

Open SurfViewer from Manage subscriptions

  1. Open Manage subscriptions in AWS Marketplace.
  2. Find the active SurfViewer subscription in the list.
  3. Select Set up product to continue into the buyer setup flow.
This page confirms that SurfViewer is already an active subscription and is ready for buyer-side setup.
SurfViewer subscription confirmation in AWS Marketplace
Manage subscriptions shows SurfViewer as an active subscription with the next action to set up the product.
4
Setup

Open the vendor account setup from the purchase page

  1. After opening the active SurfViewer subscription, continue to the purchase page.
  2. Review the message that your AWS Marketplace subscription is already accepted.
  3. Select Set up your account to continue with the vendor-side account setup.
This step connects your AWS Marketplace subscription to the SurfViewer account setup flow before you return to AWS Marketplace to launch the deployment template.
AWS Marketplace Configure and launch page for SurfViewer
The purchase page confirms the accepted subscription and sends you to vendor account setup.
5
Template

Use AWS Marketplace Quick Launch to open the CloudFormation template

  1. On the Configure and launch page, review the required permissions and complete the vendor sign-in step if prompted.
  2. Under Step 3, select Launch template.
AWS Marketplace Launch template action for SurfViewer
Configure and launch uses AWS Marketplace Quick Launch to open the reviewed CloudFormation template.
6
Quick Launch

Create the SurfViewer stack

  1. Review the stack parameters provided by SurfViewer.
  2. Choose and fill in the naming prefix, datastore choice, admin email, viewer emails, and any optional viewer-hosting settings needed for your account.
  3. You may choose an existing Healthimaging datastore if available to reduce a fixed monthly cost.
  4. Confirm capabilities and create the stack.
  5. Watch the stack until it reaches CREATE_COMPLETE.
AWS CloudFormation Quick Create Stack page for SurfViewer
Quick Create launches the buyer stack using the SurfViewer Marketplace template.
7
Deployment

Open the completed stack and capture the entry URLs

  1. Open the completed CloudFormation stack.
  2. Review the outputs for the viewer URL, admin URL, API URL, and any generated supporting resources.
  3. The viewer URL is the AdminBaseURL/viewer, admin URL is AdminBaseURL/admin.
  4. Open the viewer URL for users and the admin URL for setup.
Deployed SurfViewer CloudFormation stack in AWS
The completed stack is the handoff point from infrastructure deployment to SurfViewer application setup.
8
Admin

Continue with onboarding

  1. If you already input bootstrap admin and viewer emails, proceed to the next step.
  2. Open the admin page from the deployed environment.
  3. Use the generated commands and operational steps to prepare your tenant for viewer users, administrators, and sharing roles.
The admin guide is where you transition from infrastructure into tenant setup and operator enablement.
SurfViewer AWS admin guide and onboarding
Use onboarding to prepare operator access and role setup for the tenant.
9
Ingestion

Finish ingestion setup

  1. Open the ingestion section from the admin guide.
  2. Enter the operator email address and generate the commands for your AWS account and target stack.
  3. Run the first two PowerShell commands as the AWS account administrator. These create the IAM Identity Center user if needed and assign the bulk-ingest permission set for this stack.
  4. Then have the operator run the AWS SSO sign-in commands followed by the upload command to complete ingestion setup and import studies.
Once onboarding and ingestion setup are complete, you are ready to ingest studies and open the viewer with real data.
SurfViewer AWS admin guide and ingestion setup
The ingestion guide walks through operator setup and study import preparation.
10
Viewer

Open SurfViewer, sign in, and confirm the study list

  1. After onboarding and ingestion setup are complete, open the viewer URL from the completed stack outputs in your browser.
  2. Sign in with one of the viewer accounts configured for the deployment.
  3. Confirm that the study list loads successfully in SurfViewer.
SurfViewer extends the OHIF viewer workflow, making it easier for imaging teams to follow a familiar, clinically proven viewing experience.
SurfViewer sign-in and study list based on an OHIF workflow
Open SurfViewer in the browser, sign in, and confirm the familiar OHIF-based Viewing experience.