Installation

Installation

Pala is currently in V3 Beta and available as self-hosted. This guide walks through setting up PalaCMS using Docker. PalaCMS uses Pocketbase, so see also https://pocketbase.io/docs/going-to-production/ for more information about production deployments.

How to install PalaCMS using Docker?

  1. Point domain name using DNS to the server you are going to use for hosting PalaCMS.

  2. Prepare Docker deployment using Docker Compose or by running docker commands on the server.

  • Use ghcr.io/palacms/palacms:latest as the image.
  • Add volume for path /app/pb_data. This is where all files and the database will be stored.
  • Optinally you can add following environment variables to perform setup more securely. The environment variables only take effect when PalaCMS starts for the first time.
    • PALA_APP_URL - Sets base URL that's used for generating links in the backend (eg. emails).
    • PALA_SUPERUSER_EMAIL + PALA_SUPERUSER_PASSWORD - Creates initial superuser account.
    • PALA_USER_EMAIL + PALA_USER_PASSWORD - Creates initial user account.
  1. Navigate to the domain name to setup PalaCMS. Setup only starts when superuser was not created in the previous step using environment variables.

  2. Configure Pocketbase settings by navigating to the address https://example.com/_/ (replace domain name with your own).

  3. Create your first site by navigating to address https://example.com/admin (replace domain name with your own). Note that site is created using the domain name that is used for accessing the CMS.

Example Docker Compose configuration (compose.yaml)

services:
  palacms:
    image: ghcr.io/palacms/palacms:latest
    restart: always
    ports:
        - 8080:8080
    volumes:
      - palacms-data:/app/pb_data

volumes:
  palacms-data: