1---
2title: Get started
3description: Learn how to get started with EAS Update and use it in your project.
4---
5
6import { Terminal } from '~/ui/components/Snippet';
7import { Step } from '~/ui/components/Step';
8
9Setting up EAS Update allows you to push critical bug fixes and improvements that your users need right away.
10
11<Step label="1">
12## Install the latest EAS CLI
13
14EAS CLI is the command line app you will use to interact with EAS services from your terminal. To install it, run the command:
15
16<Terminal cmd={['$ npm install --global eas-cli']} />
17
18You can also use the above command to check if a new version of EAS CLI is available. We encourage you to always stay up to date with the latest version.
19
20> We recommend using `npm` instead of `yarn` for global package installations. You may alternatively use `npx eas-cli@latest`; remember to use that instead of `eas` whenever it's called for in the documentation.
21
22</Step>
23
24<Step label="2">
25## Log in to your Expo account
26
27If you are already signed in to an Expo account using Expo CLI, you can skip the steps described in this section. If you are not, run the following command to log in:
28
29<Terminal cmd={['$ eas login']} />
30
31You can check whether you are logged in by running `eas whoami`.
32
33</Step>
34
35<Step label="3">
36## Create a project
37
38Create a project by running:
39
40<Terminal cmd={['$ npx create-expo-app']} />
41</Step>
42
43<Step label="4">
44## Configure your project
45
46To configure your project, run the following commands in the order they are specified:
47
48<Terminal
49  cmd={[
50    '# Install the latest `expo-updates` library',
51    '$ npx expo install expo-updates',
52    '',
53    '# Initialize your project with EAS Update',
54    '$ eas update:configure',
55    '',
56    '# Set up the configuration file for builds',
57    '$ eas build:configure',
58  ]}
59  cmdCopy="expo install expo-updates && eas update:configure && eas build:configure"
60/>
61
62After running these commands, **eas.json** file will be created in the root directory of your project.
63
64Inside the `preview` and `production` build profiles in **eas.json**, add a `channel` property for each:
65
66```json eas.json
67{
68  "build": {
69    "preview": {
70      "channel": "preview"
71      // ...
72    },
73    "production": {
74      "channel": "production"
75      // ...
76    }
77  }
78}
79```
80
81The `channel` allows you to point updates at builds of that profile. For example, if we set up a GitHub Action to publish changes on merge, it will make it so that we can merge code into the "production" Git branch. Then, each commit will trigger a GitHub Action that will publish an update which will be available to builds with the channel "production".
82
83> **Optional**: If your project is a bare React Native project, see [Updating bare app](/eas-update/updating-your-app/) for any additional configuration.
84
85</Step>
86
87<Step label="5">
88## Create a build for the project
89
90You need to create a build for Android or iOS. We recommend creating a build with the `preview` build profile first. See [Creating your first build](/build/setup/) on how to get started and set up [Internal distribution](/build/internal-distribution/#setting-up-internal-distribution) for your device or simulator.
91
92Once you have a build running on your device or a simulator, you are ready to send an update.
93
94</Step>
95
96<Step label="6">
97## Make changes locally
98
99After creating the build, you are ready to iterate on the project. Start a local development server with the following command:
100
101<Terminal cmd={['$ npx expo start']} />
102
103Then, make any desired changes to your project's JavaScript, styling, or image assets.
104
105</Step>
106
107<Step label="7">
108## Publish an update
109
110To publish an update to the build, run the following command:
111
112<Terminal
113  cmd={[
114    '$ eas update --branch [branch] --message [message]',
115    '',
116    '# Example',
117    '$ eas update --branch preview --message "Updating the app"',
118  ]}
119  cmdCopy={null}
120/>
121
122Once the update is built and uploaded to EAS and the command completes, force close and reopen your app up to two times to download and view the update. By default, `expo-updates` checks for updates every time the app is loaded. However, you can also implement a custom strategy with the [Updates API](/versions/latest/sdk/updates) and [app config](/versions/latest/config/app/#updates). If your app is not updating as expected, [validate your configuration](/eas-update/debug).
123
124</Step>
125
126## Next steps
127
128You can publish updates continuously with GitHub Actions. See [Using GitHub Actions with EAS Update](/eas-update/github-actions) for more information.
129