Postiz Server Deployment Overview¶

Prerequisites¶

The following configuration parameters and system requirements are required for the application to function correctly:

Operating System: Ubuntu.
Access: Root privileges to manage Docker and system directories.
Network Settings: Ports 80 and 443 must be open for web server operation and SSL certificate acquisition.

FQDN of the final panel on hostkey.in domain¶

A dynamic subdomain based on the server ID is used to access the application.

Parameter	Value
Prefix	`postiz`
Domain	`hostkey.in`
Full Template	`postiz{Server_ID_from_Invapi}.hostkey.in`

File and Directory Structure¶

The following directories are used to store configurations, application data, and certificates:

/opt/postiz — Application working directory (contains files from the postiz-docker-compose repository).
/root/nginx — Directory containing the compose.yml configuration file for the proxy server.
/data/nginx/user_conf.d — Directory for Nginx user configurations.
/data/nginx/nginx-certbot.env — Environment variables file for Certbot.

Application Installation Process¶

Deployment is performed by cloning the https://github.com/gitroomhq/postiz-docker-compose.git repository into the /opt/postiz directory. During installation, the domain name is automatically injected into the following internal configuration variables:

MAIN_URL
FRONTEND_URL
NEXT_PUBLIC_BACKEND_URL

Docker Containers and Execution¶

The application is deployed using two main components in containers.

Nginx Certbot (Proxy Server)¶

This container handles HTTPS traffic processing and automatic SSL certificate acquisition.

Image Name: jonasal/nginx-certbot:latest
Ports: Uses host network mode.
Volumes:
nginx_secrets:/etc/letsencrypt — Certificate storage.
/data/nginx/user_conf.d:/etc/nginx/user_conf.d — Proxy configuration files.
Environment Variables: [email protected].
Restart Policy: unless-stopped.

Postiz (Application)¶

The main application container, launched via Docker Compose.

Container Name: postiz{Server_ID_from_Invapi}.hostkey.in
Operation Mode: Runs as part of the project from /opt/postiz.

Application Update Instructions¶

Updates are performed by pulling the latest images and restarting the containers:

cd /opt/postiz && docker compose pull && docker compose up -d

Additionally, use the following command to update the proxy server:

cd /root/nginx && docker compose up -d

Configuration Files and Data Locations¶

Data Type	File / Directory Path
Docker Compose application configuration	`/opt/postiz/docker-compose.yaml`
Proxy server configuration	`/root/nginx/compose.yml`
SSL Certificates	`nginx_secrets` (inside the container)

Available Connection Ports¶

443 (HTTPS): Primary port for accessing the application interface via the domain name.
80 (HTTP): Used for redirection to HTTPS and certificate acquisition.