🚀 PocketBase Docker Setup

A straightforward way to run PocketBase using Docker and Docker Compose.

---

💻 Prerequisites

Make sure you have these installed:

• Docker: Installation Guide
• Docker Compose: Installation Guide (Often included with Docker Desktop)

---

⚙️ Getting Started

1. Get Files: Save the Dockerfile and docker-compose.yaml into a new empty directory on your computer.

2. Navigate: Open your terminal or command prompt and cd into that directory:

   cd path/to/your/project-directory

3. Build & Run: Execute the following command:

   docker compose up -d --build

   (This builds the image and starts the container in the background. The --build flag is only essential the first time or if you modify the Dockerfile, but including it is safe.)

4. Initial Admin Setup: Wait a few seconds for the container to initialize. Then, open your web browser to: http://localhost:8080/_/

   Follow the on-screen instructions to create your first admin account (email/password). This setup step is only needed on the very first run when the data volume is empty.

---

🔗 Accessing PocketBase

• Admin UI: http://localhost:8080/_/
• API Endpoint: http://localhost:8080/ (for your app interactions)

---

💾 Data Persistence

• Your PocketBase data (database files, uploaded assets, logs) is stored persistently in a Docker named volume called pocketbase_data.
• This volume is defined at the bottom of the docker-compose.yaml file.

Important: Your data will remain even if you stop and remove the container using docker compose down. The volume is kept separately.

---

🛑 Stopping the Service

To stop and remove the PocketBase container (but keep the persistent data volume):

1. Make sure you are in the same directory as your docker-compose.yaml file in your terminal.
2. Run the command:

   docker compose down

---

▶️ Restarting

To start the container again using your existing data:

1. Navigate to the project directory in your terminal.
2. Run:

   docker compose up -d