WHAT YOU’LL LEARN
  • how to create a brand new Webiny project
  • how to deploy it to your AWSexternal link account

Prerequisites
anchor

Before proceeding, make sure you have the following:

  1. Node.js ^18 || ^20
  1. yarn ^1.22.21 || >=2
  1. AWS account and user credentials

Project Setup
anchor

Once you have all the prerequisites in place, we recommend creating a new Webiny project using create-webiny-project - a tool that sets everything up automatically for you. So, in your terminal of choice, run the following command:

From there, follow the on-screen setup instructions, which includes answering a couple of project-related questions, and doing your first deployment.

Pick Your Database Setup
anchor

Webiny supports two database setups:

  1. Amazon DynamoDB (for small and medium sized projects)
  2. Amazon DynamoDB + Amazon OpenSearch (for large / enterprise-level projects)

If you’re building a small project (couple of thousands of database records) or just giving Webiny a try, we suggest you go with the Amazon DynamoDB database setup. On the other hand, if you’re building a larger project and you know you will be dealing with hundreds of thousands or even millions of database records, choose the Amazon DynamoDB + Amazon OpenSearch database setup.

Please choose your database setup with consideration for both present and future project requirements. The decision you make at this point cannot be changed later on without recreating your project from scratch.

Amazon DynamoDB + Amazon OpenSearch - Monthly Cost❗
anchor

Although Webiny is designed to rely on serverless cloud infrastructure resources, the Amazon DynamoDB + Amazon OpenSearch database setup relies on Amazon OpenSearch Serviceexternal link, which is not serverless.

More precisely, it doesn’t scale to zero and it’s billed per hour of usage. The cheapest configuration (which Webiny deploys for your development-related environments) amounts to roughly $25/month. For more information, please refer to the Amazon OpenSearch Service pricingexternal link page.

First Deployment
anchor

Once your new project has been created, it’s time to deploy it into your AWS account. You can do that simply by running the following command in your terminal:

Cloud Infrastructure

Learn what gets deployed into your AWS account and how it all works in the Cloud Infrastructure key topics section.

Note that the first deployment can take up to 15-30 minutes! So, even though it might look nothing is happening in the terminal, please be patient and let the process finish. If something went wrong, an error will be shown.

Ultimately, once the deployment has been done, you are presented with the URL over which you can access your Admin Area, and finish the installation.

Admin Area - Installation WizardAdmin Area - Installation Wizard
(click to enlarge)
Misplaced Admin area URL?

Running the yarn webiny open admin --env dev command in your Webiny project folder will open the Admin Area URL in your default browser.

You can also run yarn webiny info to get a list of all important URLs.

Telemetry

Please note that, by default, Webiny collects anonymous usage information, which is exclusively used for improving the product and understanding usage patterns. Please take a look at our Telemetry page for more information on this subject.

If, at any point in time, you wish to disable this behaviour, you can do it with the Webiny CLI, by running the following command: yarn webiny disable-telemetry.

Troubleshooting
anchor

SubscriptionRequiredException: The AWS Access Key Id Needs a Subscription for the Service
anchor

In some cases, upon deploying a new Webiny project, it’s possible for users to experience the following error being thrown in their terminal:

The following are some of the reasons why you might be receiving this error:

  1. you didn’t verify your phone number
  2. you didn’t verify your payment method
  3. you didn’t select a support subscription (free or other)
  4. if you created a brand new AWS account, it wasn’t yet processed on the AWS side

The account signup and verification process can be completed via https://portal.aws.amazon.com/billing/signup?type=resubscribe#/resubscribedexternal link.

Pulumi Is Throwing asyscall.loadsystemlibraryException
anchor

There could be various reasons why this error was thrown. But, if deploying from a Windows machine, we’ve seen that it could be caused by an anti-virus software that you might have installed on your machine. Our suggestion is to try to temporary disable it and see if that produces any positive outcome.