What is ? Pocketbase is an open-source backend solution offering a real-time database, file storage, and seamless user authentication with OAuth integration, all readily available right out of the box. Pocketbase In this post, we’ll cover how to deploy Pocketbase using Docker and Nginx on an machine (although the instructions would also work for any Debian-based Linux distribution). Additionally, we will cover provisioning an SSL certificate using Certbot for enhanced security. Ubuntu Prerequisites Before we begin, ensure that you have the following: An Ubuntu machine or server (these instructions apply to other Debian-based Linux distributions as well). Docker installed on your system. Basic knowledge of Docker and command-line usage. Nginx installed on your system with certbot Here are articles on installing , , and . docker nginx certbot Installing PocketBase With Docker We'll use a slightly modified version of the docker-compose.yml from the repository. muchobien/pocketbase-docker Step 1 Create a docker-compose.yml file in a directory of your choice. The contents of the file are provided below: version: "3.7"
services:
  pocketbase:
    image: ghcr.io/muchobien/pocketbase:latest
    container_name: pocketbase
    restart: unless-stopped
    command:
      - --encryptionEnv 
      - ENCRYPTION 
    environment:
      ENCRYPTION: YOUR_ENCRYPTION_KEY 
    ports:
      - "8091:8090"
    volumes:
      - ./pb_data:/pb_data
      - ./pb_public:/pb_public 
      - ./pb_migrations:/pb_migrations 
    healthcheck: 
      test: wget --no-verbose --tries=1 --spider http://localhost:8090/api/health || exit 1
      interval: 5s
      timeout: 5s
      retries: 5 Step 2 To start the docker container we run the following command in the terminal: $ docker compose up -d --build This starts a pocketbase instance and exposes it on port 8091. The , , and folders created are bound to the folder in the container. pb_data pb_public pb_migrations Step 3. Next, we create an Nginx instance to give access to our application. To keep things simple, we will work with the default configuration file. Run the command below: $ nano /etc/nginx/sites-available/default Add the following code to the end of the file and save, replacing with your domain name or the subdomain you want to create: app.example.com server {
    server_name app.example.com;

    location / {
        proxy_pass http://127.0.0.1:8091;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

} Next, test that your Nginx configuration is valid: $ sudo nginx -t You should get a message like the one below if everything is fine: nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful Then, restart Nginx: $ sudo systemctl restart nginx Finally, we generate our SSL certificates using certbot: $ sudo certbot --nginx -d app.example.com Congrats, you have now set up PocketBase secured with SSL. The following are the routes: - Serves the static content (html, css, images, etc.) from the directory. https://app.example.com pb_public - The admin dashboard UI https://app.example.com/_/ - The REST API https://app.example.com/api/ Conclusion Following this tutorial, you now have deployed PocketBase successfully. Also published here.

Too Long; Didn't Read

Developers: Build Less. Deliver More. [Learn how]	

How To Deploy Pocketbase Using Docker, Nginx and SSL

Too Long; Didn't Read

Russell

About Author

TOPICS

THIS ARTICLE WAS FEATURED IN...

How To Deploy Pocketbase Using Docker, Nginx and SSL

Too Long; Didn't Read

Russell

About Author

TOPICS

THIS ARTICLE WAS FEATURED IN...

RELATED STORIES