Introduction
BookWyrm is an open-source, federated book reading platform that allows users to discover, read, and discuss books. This guide will walk you through the process of installing BookWyrm on Debian 12.
Prerequisites
Before you begin, ensure you have:
- A Debian 12 server or desktop system
- Root or sudo privileges
- Python 3.7 or later installed
- Git installed
- A domain name pointing to your server (optional)
Step 1: Install Dependencies
Update the package index and install required dependencies:
sudo apt update
sudo apt install -y python3-pip python3-venv git build-essential libpq-dev python3-devStep 2: Clone BookWyrm Repository
Clone the BookWyrm repository from GitHub:
git clone https://github.com/bookwyrm-social/bookwyrm.git
cd bookwyrmStep 3: Set Up Virtual Environment
Create a virtual environment for BookWyrm:
python3 -m venv venv
source venv/bin/activateStep 4: Install Python Dependencies
Install Python dependencies using pip:
pip install -r requirements.txtStep 5: Configure BookWyrm
Create a local settings file and set up the database:
cp bookwyrm/settings/local.py.example bookwyrm/settings/local.py
python manage.py migrate
python manage.py collectstaticStep 6: Create Superuser
Create a superuser for the BookWyrm instance:
python manage.py createsuperuserStep 7: Run BookWyrm
Run the BookWyrm development server:
python manage.py runserver 0.0.0.0:8000Step 8: Access BookWyrm
Access BookWyrm by navigating to your server’s IP address or domain name in a web browser, followed by port 8000 (e.g., http://your_domain_or_ip:8000).
Conclusion
Congratulations! You have successfully installed BookWyrm on Debian 12. You can now start using BookWyrm to discover, read, and discuss books.
