Quickstart
The fastest path from a fresh install to a live app — start Alaf Server, open the dashboard, and deploy one thing.
Just installed Alaf Server? This page gets you to a live app in four short steps. Think of Alaf Server as a little kitchen that runs on your own computer: you turn it on, open the door, hand it your code, and it cooks and serves the meal. No servers to rent, no config files to write.
What you need
- A computer running macOS, Linux, or Windows.
- Some code you want to put online — a GitHub repo, or a folder on your disk.
- That's it. You do not need Docker or your own server for this.
Install the Alaf Server CLI
The CLI is one small command-line tool. Copy the line for your system and paste it into a terminal:
$ curl -fsSL https://get.alafteknoloji.com | shAlready have a package manager? npm i -g alaf server works too (or pnpm, yarn, bun).
Full options — desktop app, cloud, Docker Compose — are on the Installation page.
Start Alaf Server
alaf server upThis starts Alaf Server on your machine and keeps it running in the background — it comes back on reboot and
restarts itself if it ever crashes. The API listens on :4000 and the dashboard on :3001 (the
dashboard downloads itself the first time). Everything is backed by a small built-in database, so there's
nothing else to set up.
Just want to try it once?
Run alaf server up --foreground to run it attached to your terminal instead — stop it any time with
Ctrl-C. Stop the background service with alaf server stop.
Open the dashboard
alaf server openThis opens the dashboard in your browser at http://localhost:3001. Because it's running on your own
computer, you're let straight in — no login needed.
Deploy one thing
In the dashboard, start a new project and point it at your code — a GitHub repository or a folder on your disk. Alaf Server looks at your code, figures out what kind of app it is, and shows you a summary. For most apps you don't change anything: just press Deploy.
You land on the build screen, which streams the logs live — like watching the oven through the glass door. When it finishes, you get a link. Click it, and your app is online. 🎉
Screenshot
Prefer the terminal?
You can deploy without leaving the shell. First create a project in the dashboard, then from your code folder:
cd your-project
alaf server init # pick which project this folder belongs to
alaf server deploy # build it and put it onlinealaf server init writes a small .alaf server/project.json file so later commands know which project to act
on. Add --watch to alaf server deploy to follow the build logs until it's done.
If something goes wrong
`alaf server open` says the API isn't responding
The platform isn't up yet. Run alaf server up first (give it a few seconds to become healthy), then try
alaf server open again. Check its state any time with alaf server status.
The build failed
Open the build screen and read the last few red lines — that's the real reason. First-time failures are usually a missing build command, a missing environment variable, or the app listening on the wrong port.
What next?
Installation
Desktop app, Docker Compose, cloud, and system requirements — the full set of ways to install.
First deployment
A deeper walkthrough: deploy from Git, custom domains, env vars, previews, and rollbacks.
Deploy from GitHub
Connect a repo and turn on auto-deploy so every push ships automatically.