Install Webiny

Prerequisites

Before proceeding, make sure you have the following:

1. Node.js >=22

• Node.js versions 22 or greater
• If you don’t have Node.js installed, the easiest way to install it is by downloading the official binary

2. yarn

• Webiny works with both yarn versions 1 (classic) and >=2 (berry)
• for version 1 - 1.22.0 or later is required

3. AWS account and user credentials

• in order to deploy Webiny, you must have a valid AWS account and user credentials set up on your system

Project Setup

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

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❗

Although Webiny is designed to rely on serverless cloud infrastructure resources, the Amazon DynamoDB + Amazon OpenSearch database setup relies on Amazon OpenSearch Service, 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 pricing page.

First Deployment

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:

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.