Don't forget to commit your changes to the local repository.
## Creating the Upsun configuration
Let's move to the fun part. Make sure your Upsun CLI is installed and logged in with `upsun login`.
We now need to create a new project to deploy our Remix. We will use `upsun project:create`:
```bash {filename="Terminal"} theme={null}
upsun project:create
Selected organization: Nls (nls) (by default)
Creating a project under the organization Nls (nls)
* Project title (--title)
Default: Untitled Project
> Remix Deploy
* Region (--region)
The region where the project will be hosted.
Get a 3% discount on resources for regions with a carbon intensity of less than 100 gCO2eq/kWh.
[au.platform.sh ] Sydney, Australia (AWS) [545 gC02eq/kWh]
[au-2.platform.sh] Sydney, Australia (AZURE) [545 gC02eq/kWh]
[ca-1.platform.sh] Montreal, Canada (AWS) [31 gC02eq/kWh]
[ch-1.platform.sh] Zurich, Switzerland (GCP) [91 gC02eq/kWh]
[de-2.platform.sh] Frankfurt, Germany (GCP) [416 gC02eq/kWh]
[eu.platform.sh ] Dublin, Ireland (AWS) [386 gC02eq/kWh]
[eu-2.platform.sh] Dublin, Ireland (AWS) [386 gC02eq/kWh]
[eu-4.platform.sh] Dublin, Ireland (AWS) [386 gC02eq/kWh]
[eu-5.platform.sh] Stockholm, Sweden (AWS) [23 gC02eq/kWh]
[fr-3.platform.sh] Gravelines, France (OVH) [59 gC02eq/kWh]
[fr-4.platform.sh] Paris, France (AZURE) [59 gC02eq/kWh]
[uk-1.platform.sh] London, United Kingdom (GCP) [200 gC02eq/kWh]
[us.platform.sh ] Washington, United States (AWS) [396 gC02eq/kWh]
[us-2.platform.sh] Washington, United States (AWS) [396 gC02eq/kWh]
[us-3.platform.sh] Moses Lake, United States (AZURE) [56 gC02eq/kWh]
[us-4.platform.sh] Charleston, United States (GCP) [647 gC02eq/kWh]
> us-3.platform.sh
Default branch (--default-branch)
The default Git branch name for the project (the production environment)
Default: main
>
Git repository detected: /Users/nls/psh/remix
Set the new project Remix Deploy as the remote for this repository? [Y/n]
```
Choose a name and a deployment region. The command will automatically set a new git remote on your local repository.
We now have an empty Upsun project ready to be deployed to:
```bash {filename="Terminal"} theme={null}
The Upsun Bot is activating your project
▄ ▄
▄█▄▄▄█▄
▄██▄███▄██▄
█ █▀▀▀▀▀█ █
▀▀ ▀▀
The project is now ready!
gd33gxlviuaa4
Region: us-3.platform.sh
Project ID: gd33gxlviuaa4
Project title: Remix Deploy
URL: https://console.upsun.com/01hd1s2bjt44369c0923a70g44/gd33gxlviuaa4
Git URL: gd33gxlviuaa4@git.us-3.platform.sh:gd33gxlviuaa4.git
Setting the remote project for this repository to: Remix Deploy (gd33gxlviuaa4)
```
We now need a configuration to tell Upsun how to run our project. Fortunately Upsun comes with the `upsun ify` command that will generate most of the YAML configuration automatically.
```text {filename="Terminal"} theme={null}
upsun ify
Welcome to Upsun!
Let's get started with a few questions.
We need to know a bit more about your project. This will only take a minute!
What language is your project using? We support the following: [JavaScript/Node.js]
✓ Detected dependency managers: Npm
Tell us your project's application name: [remix]
(\_/)
We're almost done... =(^.^)=
Last but not least, unless you're creating a static website, your project uses services. Let's define them:
Select all the services you are using: []
You have not selected any service, would you like to proceed anyway? [Yes]
```
We haven't selected any services here because our data is fully local. If your application need to write some local files, look for the `mounts:` key in the newly created `.upsun/config.yaml`.
## Setting up the Node.js server
As mentionned in the Remix documentation, the default setup does not come with a web server capable of handling incoming requests.
> Remix is not an HTTP server, but rather a handler inside an existing HTTP server. Adapters allow the Remix handler to run inside the HTTP server. Some JavaScript runtimes, especially Node.js, have multiple ways to create an HTTP server. For example, in Node.js you can use Express.js, fastify, or raw http.createServer.
We will go the easy route and use the Remix App Server. It is a basic production-ready node.js Express server made by the Remix team. Good enough for our use-case.
Running it locally is straight-forward:
```bash {filename="Terminal"} theme={null}
npm run build
npx remix-serve build/index.js
[remix-serve] http://localhost:3000
GET / 200 - - 544.353 ms
```
Let's implement this in our Upsun configuration. As the generated configuration already includes the build command, we just need to specify our start command. Upsun automatically inject the `$HOST` environment variable so you don't need to explicitely add it to the command.
```yaml theme={null}
web:
# Commands are run once after deployment to start the application process.
# More information: https://docs.upsun.com/create-apps/app-reference.html#web-commands
commands:
# The command to launch your app. If it terminates, it's restarted immediately.
# You can use the $PORT or the $SOCKET environment variable depending on the socket family of your upstream
start: "npx remix-serve build/index.js"
```
Commit your changes and push your code:
```bash {filename="Terminal"} theme={null}
git add .upsun
git commit -m "Add Upsun configuration"
upsun push
```
## Deploying to Upsun
The Upsun platform is now fetching the dependencies and building the project. After a couple minutes, our application is now deployed:
```bash {filename="Terminal"} theme={null}
Creating environment main
Starting environment
Updating endpoints for remix
Opening application remix and its relationships
Executing deploy hook for application remix
Opening environment
Environment configuration
remix (type: nodejs:20, cpu: 0.5, memory: 224, disk: 512)
Environment routes
http://main-bvxea6i-gd33gxlviuaa4.us-3.platformsh.site/ redirects to https://main-bvxea6i-gd33gxlviuaa4.us-3.platformsh.site/
http://www.main-bvxea6i-gd33gxlviuaa4.us-3.platformsh.site/ redirects to https://www.main-bvxea6i-gd33gxlviuaa4.us-3.platformsh.site/
https://main-bvxea6i-gd33gxlviuaa4.us-3.platformsh.site/ is served by application `remix`
https://www.main-bvxea6i-gd33gxlviuaa4.us-3.platformsh.site/ redirects to https://main-bvxea6i-gd33gxlviuaa4.us-3.platformsh.site/
Blackfire build scheduled
```
You can access the app on the auto-generated URL:
Congratulations! Our app is deployed and working. If you want to add more customization to how requests are handled, the Remix documentation explains how to implement `@remix-run/express`.