Installation
Install DorkOS and start building and running your business with an agent team
Installation
DorkOS is where you build and run your business with an agent team. It opens in a browser tab where you talk to your agents, give them work, check on what they did, and ask them to build the tools you need. Install it once, and it starts in seconds whenever you need it.
Before you start
Nothing to sign in to before you start. DorkOS walks you through connecting AI the first time it
opens: a DorkOS account, your own key, a model on your computer, or an AI app you already use.
Everything except Docker and the desktop app also needs Node.js 22 or
later, the JavaScript runtime DorkOS runs on. (The desktop app and Docker bring their own, so you
don't have to install anything else.) If your agents use git, use git 2.38 or later: older git can
be tricked into running a program when an agent looks inside a folder, and dorkos doctor tells
you which you have.
Try it without installing
Curious before you commit to anything? If you have Node.js 22.22.3 or newer, you can run DorkOS straight from npm with npx, no install step first:
npx dorkos@latestThe first run takes a minute or two: npx downloads DorkOS and compiles a couple of native pieces it depends on. After that, your browser opens, and a short welcome screen asks how your agents should run: a DorkOS account, your own key, a model on your computer, or an AI app you already use.
Like what you see? Install DorkOS for good with one of the methods below, and skip that first-run wait every time you start it.
Pick your install method
Most people should use the one-liner: it's one command and it checks your setup for you. Already comfortable with npm? Use the npm tab. On a Mac and want a real app in your dock, no terminal at all? Use the Desktop App (there is a new Windows version too, still in early testing). Running on a server, or don't want Node.js on your machine? Use Docker. Contributing to DorkOS itself? Use Self-Hosted.
One command, no yak-shaving: it checks your Node.js version, installs DorkOS, and can walk you through setup.
Install DorkOS
curl -fsSL https://dorkos.ai/install | bashThis checks for Node.js 22.22.3 or later, installs DorkOS, and asks if you'd like to run the setup wizard. Say yes and it'll ask for your preferred port, a UI theme, and which folder you want DorkOS to work in by default. You can change any of these later.
Start DorkOS
dorkosDorkOS starts on port 4242 (the address your browser uses to reach it) and opens automatically in your browser, where a short welcome screen asks how your agents should run.
CI/Automation: Skip interactive prompts with --no-prompt: bash curl -fsSL https://dorkos.ai/install | bash -s -- --no-prompt Pin a specific version: curl -fsSL https://dorkos.ai/install | bash -s 1.2.3
Port already taken? If DorkOS won't start because something else is using the port, run
dorkos --port 8081 (or any free port) to start on a different one.
Updating
DorkOS checks for a newer version every time it starts. Here's how to update on each install method.
Re-run the one-liner or update with your package manager:
curl -fsSL https://dorkos.ai/install | bashCheck your current version at any time:
dorkos --versionReference
Deeper detail for when things go sideways or you need an exact version.
Rollback and version pinning
Something broke after an update? Roll back to the version that worked.
npm install -g dorkos@0.11.0Replace 0.11.0 with the version you want. Available versions are listed on npm and GitHub Releases.
Next steps
Head to the Quickstart to open your first chat, or Configuration to customize your setup.