Manage content in the dashboard, through the REST API, or with AI assistants over MCP, each with only the permissions you grant. Deploy by uploading the release archive; the installer sets up the rest.
<?php
namespace Acme\Hello;
final class App extends \App\Core\App
{
public function boot(): void
{
// A dashboard widget
$this->registerWidget('stats', [
'title' => 'Site Stats',
'surfaces' => ['dashboard'],
'render' => fn() => '<p>Hello 👋</p>',
]);
// Hook into content
$this->addFilter('post.content', fn($html) =>
$html . '<hr>Thanks for reading!');
}
}
One PHP class and a short app.json make a complete app.
Write it yourself, or describe it to an AI with the
Basehim AI context.
The Guide walks you through it with screenshots: download, install, find your way around the dashboard, and set up your site and its email. No coding needed.
Themes, apps, the REST API and AI agents: reference with code examples, and tutorials that build something that works.
Developer docsChoose where to run it. The web installer then sets up the database, the tables and your admin account.
Upload it and create a database
In your control panel's File Manager, upload the zip to your website's folder (usually public_html), extract it, and move everything out of the basehim folder. Then create an empty MySQL database.
Open your site
The installer opens by itself. Enter the database details, your site's name and your account. Four short screens and you're signed in.
curl -L -o basehim.zip \
https://github.com/basehim/basehim/releases/latest/download/basehim.zip
unzip basehim.zip && cd basehim
php -S localhost:8000 server.php
# open http://localhost:8000 — the installer startsNeeds PHP 8.1+ and a MySQL or MariaDB database. No database handy? One container is enough:
docker run -d --name basehim-db -p 3306:3306 \
-e MARIADB_ROOT_PASSWORD=secret -e MARIADB_DATABASE=basehim mariadb:11
# installer: host 127.0.0.1 · database basehim · user root · password secretMore in Installing for development.
git clone https://github.com/basehim/basehim.git
cd basehim
php -S localhost:8000 server.php
# open http://localhost:8000 — the installer startsThe repository contains the complete application, so a clone can be served directly. Pull requests are welcome: contributing guide.
Full system requirements. Every step with screenshots, and what to do if something goes wrong: How to install Basehim on your hosting
Posts, pages, media, comments, categories, tags, menus, users and settings, as JSON. Anything you can do in the dashboard, a script or another system can do too.
Connect Claude or another MCP client to your site. You approve each permission it asks for: an assistant allowed to draft posts cannot see your users or change settings.
An app is one PHP class and an app.json. If an app breaks, Basehim switches it off and keeps your site up.
PHP templates and a stylesheet. Menus, widget areas and Customizer options are declared in theme.json.
Install themes and apps from inside the admin. Every download is checked against its checksum before it is installed.
Runs on any server with PHP 8.1 and MySQL or MariaDB, including managed hosting with cPanel or Plesk, at the domain root or in a subfolder. New versions install from the Updates screen.
Basehim 1.3.0 brings light and dark mode to the whole admin, seven accent colours, status colours that never change, a shared colour palette for apps and themes, pages that load without flicker, better contrast, and a security fix for PHP's error log file.
Asif Mughal
Free and MIT licensed. Download it now, or read the Guide first to see what installing involves.