(*• ˕ •˶マ
fargone / docs / quickstart

Deploy your first app

Fargone runs your code with nixpacks, inside Docker. You can ship from a zip file or straight from a GitHub repo — no config needed in most cases.

What you need

  • A Fargone account (sign up is self-serve; this instance may require admin approval)
  • A directory of code that nixpacks can build (Next.js, Node, Python, Go, Rust, PHP, Ruby, Deno, Bun, static sites, …)

Option A — upload a zip

  1. zip -r app.zip . from your project root (exclude node_modules)
  2. In the dashboard, create an app and choose Upload a zip
  3. Open the app, hit Upload zip
  4. nixpacks detects the runtime, builds a Docker image, and starts the container
  5. Your app is live at {app}.platform.fargone.sh

Option B — connect a GitHub repo

  1. Create an app, choose Connect a GitHub repo, paste the repo URL and branch
  2. Hit Deploy — Fargone clones the repo and builds it
  3. Turn on auto-deploy to redeploy on every push (see the webhook docs)

Where does my app live?

  • Public URL: https://{app}.platform.fargone.sh
  • Local: http://localhost:{port} (shown on the app page)

Changing the port

Nixpacks containers default to listening on port 3000. Set a custom internal port on the app settings if your service uses something else.

Next steps