Self-host libSQL Server on a VPS
Server for libSQL, the open contribution fork of SQLite, speaking the Hrana protocol over HTTP. Runs as a single primary node with data on a volume.
levelrail-cli templates deploy libsql --name my-libsqlSpecification
- Status
- Listed
- Category
- Database Tools
- Services
- libsql
- Ports
- 8080
- Volumes
- 1
- Memory
- about 128 MiB
- arm64
- unknown
- amd64
- unknown
- Settings to fill in
- none
- License
- Permissive license, MIT
- Listing
- Community template
About libSQL Server
Server for libSQL, the open contribution fork of SQLite, speaking the Hrana protocol over HTTP. Runs as a single primary node with data on a volume.
What it deploys
libSQL Server runs as one service in a single Compose app, listening on port 8080, with 1 named volume mount.
| Service | Image | Tag | Ports | Volumes |
|---|---|---|---|---|
| libsql | ghcr.io/tursodatabase/libsql-server | v0.24.32 | 8080 | data -> /var/lib/sqld |
Before you install
- CPU architecture. arm64 unknown. The scan could not read a manifest or the tag is chosen at install time. This is not a claim either way.
- Listed. It is in the catalog. Back up the data volume before changing an image tag.
Settings and environment
You do not have to fill in anything. Values are never shown here.
| Service | Variable | Value |
|---|---|---|
| libsql | SQLD_HTTP_LISTEN_ADDR | Preset by the template |
| libsql | SQLD_NODE | Preset by the template |
First run
- Connect a libSQL client to this address. The server has no login, so keep it private or put an auth layer in front.
Install libSQL Server on a VPS
-
Install Levelrail on a fresh VPS
Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.
curl -fsSL https://levelrail.com/install.sh | sudo sh -
Sign in
Open the setup link, choose a password, then log the CLI in. The CLI install command is
curl -fsSL https://levelrail.com/install-cli.sh | shif the machine does not have it. See Getting started.levelrail-cli login --device -
Read the template
Shows the entry, including its full compose.yaml.
levelrail-cli templates get libsql -
Deploy it
This deploys the template compose file as an app. The app name defaults to the template id; --name sets another.
levelrail-cli templates deploy libsql --name my-libsql
Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then libSQL Server.
Docs and upstream
More in Database Tools
- MariaDBThe MariaDB database server on the official image, with a persistent volume, generated root and user passwords, and an application database. It is not published on the host, so reach it from other services in this project at mariadb:3306.
- MariaDB with AdminerA MariaDB 11.8 server paired with the Adminer web console, already wired together. The database is not published on the host, so other services in this project reach it at db:3306. Sign in to Adminer with server db, user root and the generated root password.
- InfluxDBAn open-source time-series database for metrics, events, and IoT analytics.
- MemcachedA fast in-memory cache for query results, sessions and rendered pages, reachable by other apps on host memcached.
- MilvusA cloud-native vector database built for billion-scale similarity search, run here as a single standalone node. Has no authentication, so reach it from other services in this project at milvus:19530, or attach a domain (it routes to port 19530 only) only behind Basic Auth. Not published on the host.
- Mongo ExpressA web admin console for MongoDB, bundled with its own MongoDB 7 instance and basic auth.