Skip to content

Three important steps you need to complete before setting up your first Appwrite project_

Are you getting errors when setting up your first project in Appwrite? Take a look at these steps.

3 min readUpdated Jun 29, 2026

When creating a new project, there are three important things you need to do to ensure you have things set up properly and can connect to your Appwrite backend.

Forgetting to complete one of these steps will result in errors later when trying to make your first request, so let’s jump in and see what they are so things are set up properly for your next project.

1 - Add a platform

After creating a new project in the Appwrite console, you’ll need to add a platform in order to connect an SDK. You can add a platform from the “overview” tab under the “Add a platform” section. From here, you’ll need to choose between one of the four client-side SDK’s or generate an API key with a server-side SDK.

If you’re adding an API key to use one of the server SDK’s, you’ll be asked to set scopes for the key. This sets permissions, allowing us to dictate what permissions this API key has over certain parts of our application.

Appwrite Console adding a platform
Appwrite Console adding a platform

2 - Add a hostname

When using the Web SDK, you’ll need to set a hostname. This just tells Appwrite what origin you’ll be connecting from. Failing to set the right hostname will result in CORS error later, so be sure you pay attention when setting this. I just put out a full video and an article about handling CORS errors, so be sure to check that out if you have questions or face any problems.

Hostname
Hostname

3 - Permissions

Before you can read and write data from an Appwrite database table or storage bucket, you’ll need to ensure you have the proper permissions set. This can be set from the “Settings” tab under the “Permissions” section inside a table or storage bucket.

Permissions overview
Permissions overview

With these three steps to complete, you should be set to connect to an Appwrite backend from either a client or server SDK.

Resources

Visit our documentation to get started, join us on Discord to be part of the discussion, or visit our blog and YouTube channel to learn more!

Read next

Introducing Appwrite Explorer

Eldad Fux

Appwrite Explorer brings the Appwrite REST API into the Console. Browse every endpoint, build requests with guided forms, send live calls against your project, and inspect responses without leaving the browser.

8 min read

Introducing Appwrite Terminal

Eldad Fux

Appwrite Terminal runs the Appwrite CLI directly inside the Console. Your session and project context are preconfigured, with keyboard-first controls and multi-tab workflows, so you can inspect resources without leaving the project.

7 min read

Ready to build?_