w wokku
Get Started
~/docs
/
apps

Create & Deploy

Create an app, push your code with git, and get a live URL at my-app.wokku.app.

Updated 2026-11-07 · Edit on GitHub ↗

You’ll create an app, add your SSH key once, and git push to deploy.

1. Create the app

  1. Go to Apps → + New app.
  2. Enter a name, for example my-app.
  3. Set Resources (CPU and RAM sliders, or a preset). Leave the free size for a hobby app.
  4. Optionally tick shared add-ons (Postgres, MariaDB, Redis) or pick a dedicated database.
  5. Click Create App.

App names use lowercase letters, numbers and hyphens, and must start with a letter.

2. Add your SSH key (once)

Git pushes are authenticated by your SSH key.

bash
wokku ssh-keys:add --name laptop          # uploads ~/.ssh/id_ed25519.pub

Or paste it under Profile → SSH Keys. See SSH Keys.

3. Push your code

bash
git remote add wokku git@git.wokku.cloud:my-app
git push wokku main

The remote and push command are also on the app’s Deploy tab, with copy buttons. When the build finishes, your app is live at https://my-app.wokku.app.

No git? Deploy a local folder instead: wokku deploy:tarball my-app .

How the build works

  • If your repo has a Dockerfile at the root, Wokku builds it. See Deploy with a Dockerfile.
  • Otherwise Wokku detects your language and builds with Nixpacks.
  • Your app must listen on $PORT.
  • A Procfile defines process types. web gets HTTP traffic; others (like worker) run only when you scale them. See Background Workers.

During a deploy the new container starts before the old one stops, and crashed containers restart automatically.

Run migrations

There’s no release phase, so a release: line in your Procfile doesn’t run migrations. Run them after the deploy:

bash
wokku run my-app -- bin/rails db:migrate

Check a deploy

bash
wokku deploys my-app                   # recent deploys
wokku deploys:info my-app DEPLOY_ID    # one deploy and its build log
wokku logs my-app --follow             # runtime logs

In the dashboard, open the app’s Deploy tab.

Next steps

Was this page helpful?