Memcached

Description / name	Input element
Container Registry
Timezone
User ID
Group ID
Memcached Host Port

High-performance distributed memory object caching system for speeding up dynamic web applications by reducing database load.


Port	`11211`
Registry	`ghcr.io/daemonless/memcached`
Daemonless	daemonless/memcached
Source	memcached/memcached
Website	memcached.org

Version Tags

Tag	Description	Best For
`latest` / `pkg`	FreeBSD Quarterly. Uses stable, tested packages.	Most users. Matches Linux Docker behavior.
`pkg-latest`	FreeBSD Latest. Rolling package updates.	Newest FreeBSD packages.

Root Privileges Required

Podman on FreeBSD currently requires root. All commands must be run as root (or via doas/sudo).

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.

Deployment

Podman Compose AppJail Director Podman CLI AppJail Ansible

services:
  memcached:
    image: "ghcr.io/daemonless/memcached:latest"
    container_name: memcached
    environment:
      - PUID=1000  # User ID for the application process
      - PGID=1000  # Group ID for the application process
      - TZ=UTC  # Timezone for the container
      - MEMCACHED_ARGS=  # Additional memcached command-line arguments
    ports:
      - "11211:11211"
    restart: unless-stopped

# .env

DIRECTOR_PROJECT=memcached
PUID=1000
PGID=1000
TZ=UTC
MEMCACHED_ARGS=

# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  memcached:
    name: memcached
    options:
      - container: 'boot args:--pull'
      - expose: '11211:11211 proto:tcp' \
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
        - MEMCACHED_ARGS: !ENV '${MEMCACHED_ARGS}'

# Makejail 

ARG tag=latest

OPTION overwrite=force
OPTION from=ghcr.io/daemonless/memcached:${tag}

podman run -d --name memcached \
  -p 11211:11211 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=UTC \
  -e MEMCACHED_ARGS= \
  ghcr.io/daemonless/memcached:latest

appjail oci run -Pd \
  -o overwrite=force \
  -o container="args:--pull" \
  -o virtualnet=":<random> default" \
  -o nat \
  -o expose="11211:11211 proto:tcp" \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=UTC \
  -e MEMCACHED_ARGS= \
  ghcr.io/daemonless/memcached:latest memcached

- name: Deploy memcached
  containers.podman.podman_container:
    name: memcached
    image: "ghcr.io/daemonless/memcached:latest"
    state: started
    restart_policy: always
    env:
      PUID: "1000"
      PGID: "1000"
      TZ: "UTC"
      MEMCACHED_ARGS: ""
    ports:
      - "11211:11211"

Interactive Configuration

Parameters

Environment Variables

Variable	Default	Description
`PUID`	`1000`	User ID for the application process
`PGID`	`1000`	Group ID for the application process
`TZ`	`UTC`	Timezone for the container
`MEMCACHED_ARGS`	``	Additional memcached command-line arguments

Ports

Port	Protocol	Description
`11211`	TCP	Memcached TCP port

Implementation Details

Architectures: amd64
User: bsd (UID/GID set via PUID/PGID). Defaults to 1000:1000.
Base: Built on ghcr.io/daemonless/base (FreeBSD 15.1).

Need help? Join our Discord community.