SereniBase

Where Data Becomes Software

An open-source, self-hosted alternative to Airtable, Notion databases, and NocoDB — built to create apps, workflows, and APIs on top of your data.

---

---

⭐ If this project helps you, please consider giving it a star!
👉 https://github.com/aptlogica/sereni-base

---

🚀 What is SereniBase?

SereniBase is a production-ready, open-source platform for building data-driven systems.

Think:

👉 Airtable + NocoDB
👉 But modular, extensible, API-first, and self-hosted

It allows teams to:

• Build internal tools
• Manage structured data
• Create workflows
• Extend backend systems

---

🔥 Why SereniBase?

Most no-code tools work… until they don’t.

Problem	SereniBase Solution
Vendor lock-in	✅ Self-hosted
Limited extensibility	✅ Open-source & modular
Expensive scaling	✅ Infrastructure-based cost
Privacy concerns	✅ Full data ownership

---

⚡ Key Features

• 🗄️ No-Code + Developer Friendly
• 🔌 REST API (OpenAPI/Swagger)
• 🧩 Microservices Architecture
• 🏢 Multi-Tenant Workspaces
• ⚡ Dynamic Schema (no migrations)
• 🔐 Enterprise Security (RBAC, audit logs)

---

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.