Skip to content

aptlogica/sereni-base

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

291 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

SereniBase - Open-Source No-Code Database Platform

Go React PostgreSQL Docker

Quality Gate Coverage Security License PRs Welcome Beta

Build and manage databases visually, no code required. SereniBase is an open-source platform in active beta development 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, self-hosted Airtable and NOCODB alternative that helps you create tables, relationships, views, and workflows through an intuitive interface. As a flexible database management tool with REST API support, it enables teams to build internal tools, manage structured data, and automate workflows — without writing code. Sereni Base offers one of the most quickest and user-friendly ways to build and manage databases online.

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.

Packages

 
 
 

Contributors