// DOCUMENTATION

Install CtxPost

Up and running in under 10 minutes – with Docker, Ollama, and your social media accounts.

// REQUIREMENTS

What you need

  • ✓ Docker & Docker Compose installed → Download
  • ✓ Ollama installed (for local AI) → Download
  • ✓ Git installed
  • ○ API credentials for desired platforms (optional)
  • ○ NVIDIA GPU for faster AI (optional, CPU works too)

// INSTALLATION

In 4 steps

01

Clone the repository

bash

$ git clone https://github.com/fichtmueller/ctxpost

$ cd ctxpost

02

Configure environment variables

bash

$ cp .env.example .env

$ nano .env

.env

# Required fields

DATABASE_URL="postgresql://user:pass@localhost:5432/ctxpost"

NEXTAUTH_SECRET="your-random-secret-string"

NEXTAUTH_URL="http://localhost:3000"

 

# Ollama (local)

OLLAMA_BASE_URL="http://localhost:11434"

03

Start Docker

bash

$ docker compose up -d

✔ Container ctxpost-db Started

✔ Container ctxpost-app Started

✔ CtxPost ready → http://localhost:3000

04

Pull an Ollama model

bash

# Recommended: Mistral 7B (4.1 GB)

$ ollama pull mistral

 

# Alternative: smaller model

$ ollama pull phi3

// PLATFORM CREDENTIALS

Set up API keys

For each platform you need a developer account and API access. Setup takes about 10 minutes per platform.

PLATFORM REQUIRED LINK
Facebook / Instagram App ID, App Secret, Access Token Docs →
LinkedIn Client ID, Client Secret Docs →
X (Twitter) API Key, Secret, Bearer Token Docs →
Threads Via Facebook Developer App Docs →

Questions or issues?

Open a GitHub issue or check the discussions.

Open GitHub Issue Discussions