# dudbox

> dudbox runs your apps for you: one-click apps (like Uptime Kuma) and apps from your GitHub repos, each with its own https address, and databases (Postgres, MySQL, Redis) for them. Everything you can do in the dashboard, you can do with the HTTP API, with an API token from https://dudbox.com/account.

API base URL: https://dudbox.com/api/v1. Send the token as "Authorization: Bearer $DUDBOX_TOKEN". Each docs page below is plain Markdown. For API work, start with the API overview.

## Get started

- [Introduction](https://dudbox.com/docs/index.md): what dudbox is, what you get, pricing.
- [One-click apps](https://dudbox.com/docs/apps.md): add a ready app, its admin login, its data.
- [Apps from GitHub](https://dudbox.com/docs/github.md): import a repo, what the app needs ($PORT, Railpack), deploy on push.
- [Databases](https://dudbox.com/docs/databases.md): add Postgres, MySQL or Redis, connect an app (DATABASE_URL, REDIS_URL), backups and restore to any moment.

## Your app

- [Deployments](https://dudbox.com/docs/deployments.md): what a deploy does, statuses, redeploy, roll back, cancel.
- [Env vars](https://dudbox.com/docs/env.md): add, secrets, apply with a redeploy.
- [Logs](https://dudbox.com/docs/logs.md): the app's output, live and 3 days back.
- [Metrics](https://dudbox.com/docs/metrics.md): CPU, memory, disk, network, requests, error rate and response time over time.
- [Domains and settings](https://dudbox.com/docs/settings.md): domains, port, health check, GitHub, delete.

## API

- [Overview and recipes](https://dudbox.com/docs/api/index.md): start here. Tokens, rules for agents, and recipes: add an app, import a repo, change env vars, find why a deploy failed, roll back, read logs.
- [Tokens](https://dudbox.com/docs/api/auth.md): make and check a token.
- [Services](https://dudbox.com/docs/api/services.md): one-click apps, databases, GitHub imports, list, get, delete.
- [Deployments](https://dudbox.com/docs/api/deployments.md): redeploy, deploy, roll back, wait for a deploy, build logs, cancel.
- [Env vars](https://dudbox.com/docs/api/env.md): list, read, set, delete.
- [Logs](https://dudbox.com/docs/api/logs.md): what the app writes, old and live.
- [Errors and limits](https://dudbox.com/docs/api/errors.md): error codes, the rate limit, what stays stable.

## Rules

- [Acceptable use](https://dudbox.com/docs/acceptable-use.md): what apps may not do (adult content, hate speech, email straight from our servers, spam, attacks, scraping, VPNs, proxies and torrents, crypto mining, reselling), who cannot use dudbox, what happens when a rule is broken, how to report abuse.

## Optional

- [OpenAPI 3.1](https://dudbox.com/api/v1/openapi.json): the API as one machine-readable file.