Documentation

BareStack Docs

Everything you need to deploy, configure, and troubleshoot BareStack. Self-host in minutes.

Quick Start

Get BareStack running in under 5 minutes. One command install for most systems.

bash

# One-line install (Linux/macOS)
curl -sSL https://raw.githubusercontent.com/anirudhprashant/barestack-app/main/install.sh | bash

# Or clone and run manually
git clone https://github.com/anirudhprashant/barestack-app
cd barestack-app
./install.sh

That's it!

BareStack will be running at http://localhost:8080

Installation

Detailed installation instructions for different platforms and scenarios.

Requirements

Node.js 18+ (for building)
unzip
512MB RAM minimum
1GB disk space

Step-by-Step

Clone the Repository

bash

git clone https://github.com/anirudhprashant/barestack-app
cd barestack-app

Run the Installer

The installer will:

Install npm dependencies
Download and set up PocketBase (the database)
Create all required collections automatically
Build the frontend

bash

chmod +x install.sh
./install.sh

Start BareStack

bash

./start.sh

# Output:
# ✅ BareStack CRM running!
#    App:    http://localhost:8080
#    Admin:  http://localhost:8092/_/

Create Your Account

Visit http://localhost:8080 and sign up for a new account. That's it!

Configuration

Configure BareStack for your environment.

Environment Variables

Variable	Default	Description
VITE_POCKETBASE_URL	http://localhost:8092	PocketBase server URL
PORT	8080	App server port
PB_HTTP	0.0.0.0:8092	PocketBase HTTP binding

Custom Port

bash

# Change app port (edit start.sh)
npm run preview -- --port 3000 --host 0.0.0.0 &

Cloud Setup

Deploy BareStack to production on any VPS.

Recommended VPS Providers

Hetzner

€4-6/mo, EU based, great specs

hetzner.com →

DigitalOcean

$6/mo, easy setup, good docs

digitalocean.com →

Vultr

$5/mo, global locations

vultr.com →

With Coolify (Recommended)

Coolify makes deployment dead simple — one-click install, automatic TLS, Git deploys.

bash

# Install Coolify on your VPS
curl -L https://coolify.io/install.sh | bash

# Then add your GitHub repo and deploy with:
# Repository: https://github.com/anirudhprashant/barestack-app
# Port: 8080
# Environment: VITE_POCKETBASE_URL=http://your-server:8092

With Docker

bash

# Build the app
npm run build

# Run with Docker
docker run -d \
  --name barestack \
  -p 8080:8080 \
  -p 8092:8092 \
  -v ./pb_data:/pb_data \
  barestack/app

Tech Stack

Built with modern, battle-tested open-source technologies.

React 19

Frontend framework

Fast, modern UI with hooks and concurrent features.

Vite

Build tool

Lightning-fast HMR and optimized production builds.

PocketBase

Database & Auth

Lightweight, embedded database with built-in auth and REST API.

TypeScript

Type safety

End-to-end type safety from backend to frontend.

Why These Choices?

PocketBase — Embedded DB means no separate database server to manage. Zero-config, single binary.
React + Vite — Fast DX, huge ecosystem, optimized bundles.
TypeScript — Catch bugs at compile time, better IDE support.
Tailwind CSS — Utility-first styling for robust UI layouts.

Troubleshooting

Common issues and how to fix them.

"Port already in use"

Another process is using port 8080 or 8092.

bash

# Find and kill the process
lsof -i :8080
lsof -i :8092
kill -9 <PID>

PocketBase won't start

Check if the binary is executable.

bash

chmod +x pocketbase
./pocketbase version

Build fails with memory error

Increase Node.js memory limit.

bash

NODE_OPTIONS="--max-old-space-size=4096" npm run build

Can't login after installation

Make sure you're using the correct admin credentials or create a new user account via the signup page.

Database reset

To reset PocketBase and start fresh:

bash

rm -rf pb_data
./install.sh

Need more help?

Open an issue on GitHub or check existing issues for solutions.