Installing and Verifying SQLite on Raspberry Pi OS Bookworm: A Complete Guide

 

Installing and Verifying SQLite on Raspberry Pi OS Bookworm: A Complete Guide

Aaron Rose

Aaron Rose       
Software Engineer & Technology Writer


Introduction

The Raspberry Pi is a versatile single-board computer, often used for everything from home automation to custom servers. For many of these projects, a robust yet lightweight database is essential. This is where SQLite shines. It's a self-contained, serverless, and zero-configuration database engine that stores a complete SQL database in a single file. Perfect for the Raspberry Pi's resource-conscious environment.

In this guide, we'll walk you through the process of installing SQLite on Raspberry Pi OS Bookworm, the latest Debian-based operating system. We'll also provide a comprehensive verification process, ensuring you're ready to start building your data-driven projects.


Step 1: Open the Terminal

All the commands for this process will be executed from the terminal. You can open it by clicking the terminal icon on the desktop or by pressing Ctrl + Alt + T on your keyboard.

Step 2: Update the Package Lists

Before installing any new software, it's a best practice to update your system's package list. This ensures you're fetching the latest version of the software from the repositories.

sudo apt update

You should see output indicating that your system is checking for new packages. Look for "bookworm" in the repository URLs, confirming you're on the correct OS version.

...
Get:1 http://raspbian.raspberrypi.org/raspbian bookworm InRelease [15.0 kB]
Get:2 http://archive.raspberrypi.org/debian bookworm InRelease [26.8 kB]
...
Reading package lists... Done

Step 3: Install SQLite

Now, you can install the sqlite3 package. This package includes both the core library and the command-line interface (CLI) tool.

sudo apt install sqlite3

The terminal will ask you to confirm the installation by pressing Y. The installation process is typically fast, and once it's complete, you'll be returned to the command prompt.

Step 4: Verify the Installation

A simple version check is a good first step, but a more thorough test is to create and interact with a database. This confirms the entire toolchain is working as expected.

First, check the installed version of SQLite.

sqlite3 --version

You should see an output that includes the version number, for example: 3.40.1 2023-01-28 12:28:44.

Next, let's create a test database and a simple table. This will confirm you can use the SQLite command-line tool to its full potential.

# Enter the SQLite shell, creating a new file named 'test.db'
sqlite3 test.db

You will now be in the SQLite prompt, which is different from your standard terminal prompt.

sqlite>

From here, you can enter SQL commands. Let's create a table and insert some data.

-- Create a simple table
CREATE TABLE projects (id INTEGER PRIMARY KEY, name TEXT);

-- Insert a new record
INSERT INTO projects (name) VALUES ('Home Automation');

-- Query the table to see the results
SELECT * FROM projects;

If everything worked, you should see the following output:

1|Home Automation

To exit the SQLite shell and return to your terminal, type .quit.

.quit

Conclusion

With SQLite now successfully installed and verified on your Raspberry Pi OS Bookworm system, you have a powerful and flexible database at your fingertips. Its small footprint and efficiency make it an ideal choice for a wide range of projects. You're now equipped to manage and store data locally on your Raspberry Pi. Happy building!


Aaron Rose is a software engineer and technology writer at tech-reader.blog.

Comments

Popular posts from this blog

The New ChatGPT Reason Feature: What It Is and Why You Should Use It

Raspberry Pi Connect vs. RealVNC: A Comprehensive Comparison

Running AI Models on Raspberry Pi 5 (8GB RAM): What Works and What Doesn't