Back to Apps
Papercups

Deploy Papercups on Your Own Server

Papercups is an open source live customer chat web app written in Elixir.

πŸ’¬ Communication

Want to deploy Papercups on your server faster? Try Senate with one-command setup, automatic HTTPS and monitoring.

Get Started

What is Papercups?

Papercups is an open source live customer chat web app written in Elixir. For more info visit https://papercups.io/

Self-Host Papercups

Follow these steps to deploy on your own server.

1

Install Docker

Skip this step if Docker is already installed on your server.

curl -fsSL https://get.docker.com | sh
2

Configure

Customize the settings below. Defaults work for most cases.

General
3

Deploy

Copy the configuration and run it on your server.

services:
  papercups:
    environment:
      AWS_ACCESS_KEY_ID: ""
      AWS_REGION: ""
      AWS_SECRET_ACCESS_KEY: ""
      BACKEND_URL: papercups.your-domain.com
      BUCKET_NAME: ""
      CUSTOMER_IO_API_KEY: ""
      CUSTOMER_IO_SITE_ID: ""
      DATABASE_URL: ecto://postgres:d14f1177468a4846@papercups-db/postgres
      DOMAIN: ${app_name}.${root_domain}
      FROM_ADDRESS: noreply@mail.papercups.io
      MAILGUN_API_KEY: ""
      MIX_ENV: prod
      PAPERCUPS_SLACK_CLIENT_ID: ""
      PAPERCUPS_SLACK_CLIENT_SECRET: ""
      PAPERCUPS_STRIPE_SECRET: ""
      REACT_APP_FILE_UPLOADS_ENABLED: "1"
      REACT_APP_GOOGLE_ANALYTICS_ID: ""
      REACT_APP_LOGROCKET_ID: ""
      REACT_APP_SENTRY_DSN: ""
      REACT_APP_SLACK_CLIENT_ID: ""
      REACT_APP_STRIPE_PUBLIC_KEY: ""
      REACT_APP_URL: papercups.your-domain.com
      REQUIRE_DB_SSL: "false"
      SECRET_KEY_BASE: b7e0d3e863e5ef5ed89edb5c5a6f3eadbbfd56f69fd13192c8def2bb7e9401ff
      SENTRY_DSN: ""
      SLACK_BOT_ACCESS_TOKEN: ""
    depends_on:
      - papercups-db
  papercups-db:
    image: postgres:9.6-alpine
    environment:
      POSTGRES_PASSWORD: d14f1177468a4846

Then run:

docker compose up -d
4

Access

Once started, access your app at http://localhost:4000

Why Self-Host Papercups?

Full Data Ownership

Your data stays on your servers. No third-party access.

No Monthly Fees

Pay only for your server. No per-seat or usage charges.

Complete Control

Customize, backup, and scale on your own terms.

Privacy & Compliance

Meet GDPR, HIPAA, or internal security requirements.

Technical Details

Want to go faster?

Try Senate! Senate handles Docker, HTTPS, updates, and monitoring for you. Deploy any of our 300+ apps with a single command.

Install on any Linux server:

sh -c "$(curl -sSL https://get.senate.sh)"
Get StartedBrowse All Apps