1. Create a new Encore app

In this tutorial you will create your very first Encore application, and deploy it to production using the Encore platform.

1.1 Make sure Encore is installed

If you haven't already done so, install Encore. If you're not sure, run encore version in your terminal. It should print something like:

encore version v1.0.0

1.2 Make sure Docker is installed and running

To create Encore applications with databases, you need Docker installed and running. If you haven't already, install Docker before proceeding.

1.3 Create a new app

Once you've installed Encore, creating an app is easy, simply run:

encore app create

Then pick a name for your app using lowercase letters, digits, or dashes.

Then choose one of the example applications: Hello World or Trello Clone

Next time when you're starting a new project, you also have the choice of creating an Empty app.

Once created, take a note of its App ID. This will be something like hello-world-4x3b (yours will be different).

1.4 Running your app

To run your app, open the folder created for your application. (Note: Your App ID will be different)

cd hello-world-4x3b

Then while in the app root directory, run your app by simply running:

encore run

You should see this:

$ encore run
Running on http://localhost:4060
9:00AM INF registered endpoint endpoint=World service=hello

That means your application is up and running!

While you keep the app running, open a separate terminal and call your API endpoint:

$ curl http://localhost:4060/hello.World
{"Message": "Hello, world!"}

If you see this message, you've successfully created and run your first Encore application. Well done!

1.5 Open your local development dashboard

Now that your app is running, logs, traces, and API documentation is already built in and ready to go.

Access your local development dashboard by opening http://localhost:4060 in your browser.

Next: Deploy your app to the cloud