Skip to content

remote-development.mdx

Latest commit

 

History

History
66 lines (40 loc) · 2.12 KB

remote-development.mdx

File metadata and controls

66 lines (40 loc) · 2.12 KB
Raw
title Remote Development
description Run any dev server inside an Upstash Box and access it locally over SSH port forwarding, or share it with a public URL.

Upstash Box supports full remote development workflows. By forwarding ports over SSH, you can run any web server inside a box and access it in your local browser exactly as if it were running on your machine. You can also expose it to the internet with a public URL for sharing or collaboration.

This guide uses Next.js as an example, but the same approach works for any dev server; Vite, Django, Rails, Express, and so on.

1. Create a Box

Create a box with default settings. See the quickstart if you haven't created one before.

2. Connect via SSH with Port Forwarding

Connect to your box via SSH with the -L flag to forward a port from the box to your local machine. Replace 3000 with whichever port your dev server listens on.

The box-id is the name of your box (e.g. right-flamingo-14486).

ssh -L 3000:127.0.0.1:3000 <box-id>@us-east-1.box.upstash.com

Use your Box API key as the password when prompted.

3. Start Your Dev Server

Inside the box, start your application. You can set it up manually or ask the built-in agent to build one for you. For example, with Next.js:

npx create-next-app@latest my-app
cd my-app
npm run dev

Because the SSH tunnel is active, your app is immediately accessible in your local browser at:

http://localhost:3000

You can edit files inside the box and see changes live, just as you would in a local development environment.

4. Share with a Public URL (Optional)

If you want to share your app with others, you can expose a port with a public URL from the Upstash Console. See the Public URLs guide for details.

Your app will be accessible at:

https://<box-id>-3000.preview.box.upstash.com