A web-based admin interface for Apache Cassandra, powered by alpine.js. Built with OpenResty and Lua, using the lua-cassandra library, a Cassandra driver written in pure Lua.
- Schema Management - Sidebar displaying all keyspaces, tables, and views in your Cassandra instance
- Data Viewing - Browse table and view data with customizable page sizes (50, 100, 200 rows)
- Cursor-based pagination - Cursor-based pagination using Cassandra's native paging states
- Column Type Display - Visual indicators showing data types for each column and icons distinguishing partition keys and clustering keys
- Formatted Output - cqlsh-like formatting for complex types
- Safeguards - Built-in safeguards prevent accidental modifications to system keyspaces
- Data Export - Export data as CQL, CSV, or JSON and configure row limits and choose whether to include DDL statements
- Quick table operations - Truncate or drop tables and views directly from the UI (more to come)
- Quick keyspace Operations - Drop keyspaces (more to come)
- Environment Configuration - Flexible configuration via environment variables or a configuration file
- Dark Mode - Dark mode support for comfortable viewing in low-light environments
Access the admin interface at http://localhost:8002
The application can be configured via the following environment variables:
You can also create a settings.cfg file in the same directory as the application with the following format (mapped to /etc/cassandra-admin/settings.cfg in the Docker container):
This list is not exhaustive, but here are some limitations of the current version:
- No multi-node support - Multi-host/multi-datacenter cluster support is planned for a future release. Currently connects to one contact point only.
- No user authentication - The app does not implement user authentication or role-based access control (also no LDAP, Kerberos, etc.). It is recommended to run behind a secure proxy if exposed publicly.
- No user/role management - User and role management support is planned for a future release.
- No search/filter - Cannot search or filter rows within tables. This is planned for a future release.
- No data editing - Currently read-only.
- No data import - Data import functionality is planned for a future release.
This project makes use of the following open-source libraries:
- Datatable instead of plain table
- Test with Cassandra-compatible DBs like ScyllaDB and different Cassandra versions. Make a testbed of sorts.
- Finish off UI for keyspace and table creation.
This project is an independent, open-source tool created to help administer Apache Cassandra databases. This software is not affiliated with, endorsed by, or sponsored by the Apache Software Foundation or the Apache Cassandra project.
"Apache Cassandra" and "Cassandra" are trademarks of the Apache Software Foundation. This project uses these terms solely to indicate compatibility and functionality with the Apache Cassandra database system.
The Apache Software Foundation has not reviewed, approved, or been involved in the development of this tool. For official Apache Cassandra resources, documentation, and support, please visit the official Apache Cassandra website.
This project is provided "as is" without warranty of any kind. Use at your own risk.
cassandra-admin uses an MIT License, since the main library it depends on (lua-cassandra) is also MIT licensed.
.png)



