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.

This story contains new, firsthand information uncovered by the writer.

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

How To Deploy Pocketbase Using Docker, Nginx and SSL

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Building CLI Tools with Go (Golang): A JSON File Formatter

The Noonification: How to Deal With Flapping or Broken Tests (11/29/2023)

The Noonification: Delving Into OpenTelemetry Collector (11/18/2023)

The Noonification: How to Implement a Merkle Tree in Solidity (11/12/2023)

105 Stories To Learn About K8s

104 Stories To Learn About Continuous Integration

Building CLI Tools with Go (Golang): A JSON File Formatter

The Noonification: How to Deal With Flapping or Broken Tests (11/29/2023)

The Noonification: Delving Into OpenTelemetry Collector (11/18/2023)

The Noonification: How to Implement a Merkle Tree in Solidity (11/12/2023)

105 Stories To Learn About K8s

104 Stories To Learn About Continuous Integration

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps