Project
A project groups everything related to a single deployable thing: source code, environment variables, deployments, domains, and metrics. A project belongs to either you (a personal project) or a team. Each project has:Service types
When you create a project, you pick a service type. The type determines how the project is built, run, and exposed.Web service
Long-running HTTP servers. Brimble assigns a port through thePORT environment variable; your server must listen on it. The edge terminates TLS and routes traffic to the running container.
Use for: Express, Fastify, Next.js (server mode), Django, Rails, FastAPI, Spring Boot, Phoenix, anything that listens on a port.
Static site
Pre-built HTML, CSS, and JS bundles served directly from the edge. There’s no runtime container, noPORT, no start command. You configure a build command and an output directory; Brimble serves the contents of that directory.
Use for: Next.js (static export), Vite, Astro, Hugo, plain HTML, anything where the build produces files and nothing needs to run after.
Worker
A long-running process with no HTTP port. Workers are not exposed to the internet, they’re for queue consumers, schedulers, message handlers, or any background process that does its own work. Use for: BullMQ workers, Celery workers, Sidekiq, custom queue consumers, long-polling scripts.Database
A managed data service. Brimble provisions the engine you choose, runs it, and gives you a connection string. You don’t push code to a database project, Brimble manages the image, the version, backups, and the volume. Supported engines: PostgreSQL, MySQL, MariaDB, MongoDB, Redis, Valkey, RabbitMQ, Neo4j, ClickHouse. See Deploy a database for the full list of versions and sizing options.MCP server
A Model Context Protocol server, deployed and exposed over HTTP for AI clients (Claude, Cursor, IDE extensions, agents) to connect to. Brimble runs it the same way as a web service but exposes it under a path or hostname suitable for MCP clients. Use for: connecting an MCP server to a model or agent without running it on your laptop.Project hierarchy
The Projects list summarises each project's current state.
Naming and limits
- Project names must be unique within your account or team. They appear in URLs, so use lowercase, dashes, and digits.
- Plan limits cap the number of projects per account. The free plan allows 5; paid plans go higher. See Plans and pricing.
- Region availability depends on plan tier. Some regions are paid-only.
Next steps
- Deployments, how a build becomes a running service.
- Environments, Production, Preview, and how env vars flow.
- Files, mount small config and secret files into the container.
- Service types reference, every service type, side-by-side.