# Gheima

> Gheima is a platform-as-a-service for developers and agencies in Morocco: connect a GitHub or GitLab repository and Gheima builds, deploys and runs it, with managed databases, in Oracle Cloud's Casablanca region, billed in Moroccan dirhams, with a free plan and paid plans from 90 MAD a month.

**Coding agents:** to deploy a project folder, follow [Deploy a project with an AI coding agent](https://gheima.ma/docs/deploy-with-an-agent.md): exact CLI commands from an empty machine to a live URL, the one sign-in step for the person, and what to do when a step fails.

Guides for deploying and running services on Gheima, from your first push to scaling, databases, domains and the API. Every page is also published in French (https://gheima.ma/fr/docs) and Arabic (https://gheima.ma/ar/docs).

Every docs page is available as Markdown: append `.md` to its URL, or request it with `Accept: text/markdown`.

## Start here

- [Pricing](https://gheima.ma/pricing): plans and limits in MAD, payment methods, invoices and TVA
- [Features](https://gheima.ma/features): what the platform runs, and from which plan
- [Security and data residency](https://gheima.ma/security): where workloads run and exactly what the residency commitment covers
- [Gheima vs Heroku](https://gheima.ma/compare/heroku), [vs Render](https://gheima.ma/compare/render), [vs Railway](https://gheima.ma/compare/railway): dated, sourced comparisons, including where Gheima is weaker
- [Deploy Next.js](https://gheima.ma/deploy/nextjs), [Deploy Django](https://gheima.ma/deploy/django): framework guides
- [Changelog](https://gheima.ma/changelog): dated product changes, also as an Atom feed at https://gheima.ma/changelog.xml

## Get started

- [Getting started](https://gheima.ma/docs/getting-started.md): Sign in, create a project and deploy your first service.
- [Deploy a project with an AI coding agent](https://gheima.ma/docs/deploy-with-an-agent.md): The exact commands a coding agent runs to put a project folder live on *.gheima.ma: the one sign-in step for the person, and what to do when a step fails.

## Deploy

- [Deploying apps](https://gheima.ma/docs/deploying.md): Connect a Git repo, set build and start commands, and auto-deploy on every push.
- [Templates & marketplace](https://gheima.ma/docs/templates.md): One-click deploy of WordPress, Ghost, n8n, Umami, and Uptime Kuma.
- [Environment variables](https://gheima.ma/docs/environment-variables.md): Add and edit encrypted variables, and wire a database into your service.
- [Env groups](https://gheima.ma/docs/env-groups.md): Create a reusable set of environment variables once and attach it to any number of services.
- [Deployments](https://gheima.ma/docs/deployments.md): Watch build logs, roll back to a previous build, and trigger deploys from a URL.
- [Error codes](https://gheima.ma/docs/errors.md): What each GH- code in a deploy log means, why it happened, and how to fix it.
- [Preview environments](https://gheima.ma/docs/previews.md): Get an isolated, throwaway deployment for every open pull request.
- [Static sites](https://gheima.ma/docs/static-sites.md): Serve SPAs and static builds from nginx, with redirects, rewrites and headers.

## Data

- [Databases](https://gheima.ma/docs/databases.md): Create a Postgres, Redis, MySQL or MongoDB database, connect to it and run queries. Postgres also gets snapshots and branches.
- [Object storage](https://gheima.ma/docs/object-storage.md): S3-compatible buckets with scoped keys, an object browser, and presigned URLs.
- [Persistent volumes](https://gheima.ma/docs/persistent-volumes.md): Attach a durable disk to a service so data written to a mount path survives restarts and redeploys.
- [Managed search](https://gheima.ma/docs/managed-search.md): Meilisearch instances with a scoped API key for full-text search.
- [Job queues](https://gheima.ma/docs/managed-queues.md): BullMQ-ready Redis with a scoped ACL for background jobs.
- [Transactional email](https://gheima.ma/docs/managed-email.md): Send from your own DKIM-verified domain with a delivery log.

## Operate

- [Custom domains](https://gheima.ma/docs/custom-domains.md): Point your own domain at a service and get automatic HTTPS.
- [Scaling](https://gheima.ma/docs/scaling.md): Set replicas, turn on autoscaling, and let idle services sleep to zero.
- [Cron jobs](https://gheima.ma/docs/cron-jobs.md): Run commands on a schedule, trigger them on demand, and review run history.
- [Monitoring](https://gheima.ma/docs/monitoring.md): Read live metrics, set threshold and uptime alerts, and route them to channels.
- [Webhooks](https://gheima.ma/docs/webhooks.md): Subscribe an endpoint to platform events and verify signed deliveries.

## Account

- [Team & roles](https://gheima.ma/docs/team.md): Invite members, assign roles, and understand what each role can do.
- [Account security](https://gheima.ma/docs/account-security.md): Turn on two-factor auth, review active sessions, and manage scoped API keys.
- [Single sign-on (SSO)](https://gheima.ma/docs/sso.md): Let your team sign in through your OIDC identity provider with just-in-time membership.
- [Billing & plans](https://gheima.ma/docs/billing.md): Compare plans and their limits, and manage payment in Moroccan dirham.

## Developer

- [CLI](https://gheima.ma/docs/cli.md): Install the CLI, sign in with an API key, and manage everything from your terminal.
- [REST API](https://gheima.ma/docs/api.md): Manage your account's resources over HTTP with a bearer API key.
- [SDK](https://gheima.ma/docs/sdk.md): The typed TypeScript client for Node, the browser, and edge runtimes.
- [Use Gheima with AI](https://gheima.ma/docs/ai-assistants.md): Connect Claude, Cursor, VS Code or any MCP client to your account, and give coding agents the docs in Markdown.

## Schools

- [For schools and bootcamps](https://gheima.ma/docs/for-schools.md): Cohorts, join links, assignments, the showcase and graduation.

## API

- [OpenAPI spec](https://gheima.ma/api/v1/openapi.json): the machine-readable OpenAPI 3.1 spec for the REST API at https://api.gheima.ma/v1
- [API catalog](https://gheima.ma/.well-known/api-catalog): RFC 9727 linkset pointing at the spec and the docs
- [MCP server card](https://gheima.ma/.well-known/mcp/server-card.json): how to reach the hosted MCP server
- [Agent skills](https://gheima.ma/.well-known/agent-skills/index.json): a skill that teaches a coding agent to deploy on Gheima

## Connect an AI assistant (MCP)

The hosted Model Context Protocol server is `https://gheima.ma/mcp` (Streamable HTTP, OAuth sign-in:
the person chooses read only or read and write). No install:

- Claude Code: `claude mcp add --transport http gheima https://gheima.ma/mcp`
- Cursor, VS Code and other clients: add a remote server with the URL `https://gheima.ma/mcp`

Or run it locally over stdio after `gheima login`:

```json
{ "mcpServers": { "gheima": { "command": "npx", "args": ["-y", "@gheima/mcp"] } } }
```

Locally, tools that change anything are refused unless the server is started with
`GHEIMA_MCP_ALLOW_WRITES=1`, and credential reads also need `GHEIMA_MCP_ALLOW_SECRETS=1`.
The hosted server never reads credentials.

## Optional

- [Full docs](https://gheima.ma/llms-full.txt): every page above as one plain-text file