sereni-base

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.