Templates

Deploy pre-configured apps with one click.

Available Templates

Databases

Template	Description	Default Port
PostgreSQL	Relational database	5432
MySQL	Popular SQL database	3306
MariaDB	MySQL-compatible	3306
MongoDB	Document database	27017
Redis	In-memory cache	6379

Database Admin

Template	Description	Default Port
pgAdmin	PostgreSQL admin UI	80
phpMyAdmin	MySQL/MariaDB admin	80
Adminer	Universal DB admin	8080
RedisInsight	Redis GUI	8001

Web Servers

Template	Description	Default Port
Nginx	Static file server	80
Apache	HTTP server	80
Caddy	Modern web server	80

CMS

Template	Description	Default Port
WordPress	Blog/CMS platform	80
Ghost	Modern publishing	2368
Strapi	Headless CMS	1337

Development Tools

Template	Description	Default Port
Gitea	Git server	3000
Code Server	VS Code in browser	8080
Portainer	Container management	9000
n8n	Workflow automation	5678

Monitoring

Template	Description	Default Port
Uptime Kuma	Status monitoring	3001
Grafana	Metrics dashboard	3000
Prometheus	Metrics collection	9090

Storage

Template	Description	Default Port
MinIO	S3-compatible storage	9000
File Browser	Web file manager	80

Using Templates

Via Dashboard

1. Open Basepod dashboard
2. Go to Templates
3. Click on a template
4. Enter app name
5. Click Deploy

Via CLI

# List templates
bp templates

# Deploy from template
bp deploy mydb --template postgres

Template Configuration

Each template includes sensible defaults. You can customize:

• Name: Your app name (becomes subdomain)
• Environment Variables: Pre-filled with defaults
• Volumes: Persistent storage paths

Example: PostgreSQL

Default environment:

POSTGRES_USER: postgres
POSTGRES_PASSWORD: (generated)
POSTGRES_DB: postgres

Default volume:

/var/lib/postgresql/data

Example: WordPress

Default environment:

WORDPRESS_DB_HOST: (your-db-container)
WORDPRESS_DB_USER: wordpress
WORDPRESS_DB_PASSWORD: (generated)
WORDPRESS_DB_NAME: wordpress

Connecting Apps

Templates that need databases can connect via internal networking.

1. Deploy a database (e.g., PostgreSQL)
2. Deploy your app
3. Use the internal hostname: basepod-postgres:5432

Example WordPress + MySQL:

# Deploy MySQL
bp deploy mydb --template mysql

# Deploy WordPress
bp deploy myblog --template wordpress

# In WordPress config, use:
# DB_HOST=basepod-mydb:3306

Customizing Templates

Create your own templates by forking existing ones:

1. Deploy a template
2. Configure as needed
3. Export configuration
4. Save as custom template

Or create a basepod.yaml with your configuration:

name: my-custom-app
image: myimage:latest
port: 8080
env:
  MY_VAR: value
volumes:
  - data:/app/data