github.com/aptlogica/sereni-base @v0.1.0
Chat with this repoBrowse by type
What it actually does AI analysis from the code graph — generated when you open this
README
# SereniBase - Open-Source No-Code Database Platform
Build and manage databases visually, no code required. SereniBase is a production-ready, open-source platform for creating and managing business data with a spreadsheet-like interface. Self-host on your own infrastructure with full data control.
Overview
SereniBase is an open-source alternative to Airtable, Notion databases, and NocoDB - an open source airtable alternative and airtable alternative, a nocodb alternative and an airtable and nocodb alternative. It is a no-code platform and no-code database builder that lets teams build a no-code database, a database builder, and an open source database builder; a database management tool and self hosted database for teams; a no code platform, a no-code open source database & application builder, an opensource nocodb alternative, a self hosted backend platform, and a free open source database builder. It provides a REST API backend that powers a React frontend, enabling users to create workspaces, design database schemas, and manage data through an intuitive spreadsheet-like interface.
Why SereniBase?
| Problem | Solution |
|---|---|
| Cloud-only SaaS with vendor lock-in | ✅ 100% Self-Hosted - Deploy on your infrastructure |
| Limited customization and extensibility | ✅ Open Source - MIT licensed, fork and customize |
| Expensive as data and users scale | ✅ Zero Per-User Costs - Pay only for infrastructure |
| Privacy concerns with sensitive data | ✅ Complete Data Control - Your data never leaves your servers |
Key Features
- No-Code Database Management: Create tables, define columns, add relationships through visual interface
- Multi-Tenant Architecture: Workspaces provide complete isolation for organizations and teams
- Dynamic Schema: Add/remove tables and columns at runtime without database migrations
- RESTful API: Complete REST API with Swagger/OpenAPI documentation
- Microservices Architecture: Modular services for authentication, email, storage, and antivirus
- Production-Ready: RBAC, audit logging, connection pooling, health checks, and testing
Services Architecture
| Service | Description | Port |
|---|---|---|
| sereni-base | Core REST API server | 8080 |
| PostgreSQL | Primary database | 5432 |
| JWT Provider | Authentication service | 8081 |
| Email Service | SMTP email notifications | 8082 |
| Storage Provider | File storage (MinIO/S3) | 8083 |
| Antivirus Service | ClamAV malware scanning | 8084 |
| MinIO | Object storage | 9000/9001 |
| Base UI | Frontend application | 5050 |
Quick Start
Prerequisites
| Requirement | Version | Installation |
|---|---|---|
| Docker | 20.10+ | Install Docker |
| Docker Compose | 2.0+ | Install Compose |
| Git | Latest | Install Git |
| Make | Latest | Windows: choco install make |
| SMTP Access | - | Gmail, SendGrid, Mailgun, or custom SMTP |
Installation
# Step 1: Clone the repository
git clone https://github.com/aptlogica/sereni-base.git
cd sereni-base
# Step 2: Run interactive setup wizard
make setup
# Alternative (without Make):
# Windows: .\setup-interactive.ps1
# Linux/macOS: ./setup-interactive.sh
The setup wizard will:
- Prompt for configuration (press Enter for defaults)
- Generate .env file
- Start all services with Docker Compose
Access Points
| Service | URL |
|---|---|
| Frontend | http://localhost:5050 |
| Backend API | http://localhost:8080 |
| API Documentation | http://localhost:8080/swagger/index.html |
| MinIO Console | http://localhost:9001 |
Default Login
Default credentials are configured via environment variables. See .env.example for setup.
⚠️ Security: Never use default credentials in production. Always configure secure values via environment variables.
Commands Reference
| Command | Description |
|---|---|
make setup |
Run interactive setup wizard |
make setup-y |
Run setup with default values (non-interactive) |
make up |
Start all services |
make down |
Stop services (preserve data) |
make down-all |
Stop services and remove volumes |
make logs |
View service logs |
make restart |
Restart all services |
make ps |
Show running services |
make status |
Show detailed service status |
make clean |
Remove containers (preserve data) |
make clean-all |
Full cleanup (containers + volumes + images) |
Documentation
| Document | Description |
|---|---|
| Complete Setup Guide | Comprehensive beginner guide |
| Setup Reference | Quick reference setup guide |
| Interactive Setup | Setup wizard documentation |
| Environment Variables | Configuration reference |
Security
See SECURITY.md for reporting vulnerabilities.
Contributing
We welcome contributions! See our contribution guidelines for details.
License
MIT License. Copyright (c) 2026 Aptlogica Technologies.
Extension points exported contracts — how you extend this code
Core symbols most depended-on inside this repo
Shape
Languages
Modules by API surface
For agents
$ claude mcp add sereni-base \
-- python -m otcore.mcp_server <graph>