How to self host Rowfill
Setup Rowfill in less than 5 minutes.
Prerequisites
Before you begin, ensure you have the following installed:
- Docker
- Docker Compose
- Git
Getting Started
- Clone the repository:
git clone https://github.com/rowfill/rowfill-website.git
- Configure environment variables:
- Reference the sample environment variables in mockenv
- Create your
.env
file based on the mockenv template
Third-Party Requirements
You'll need to set up the following:
- OpenAI API Key: Required for AI functionality
- SMTP Service: Choose one of:
- AWS SES
- Resend
- Similar email service
Note: The following services are automatically installed via Docker Compose:
- Weaviate
- PostgreSQL
- Redis
System Components
Rowfill consists of three main modules:
- Next.js Server: Main web application
- Worker: Background processing
- CRON Job: Scheduled tasks
Deployment
Run the application using Docker Compose:
docker compose up -d
This command will:
- Set up all required databases
- Start all three system components
- Configure networking between services
Verification
To verify your installation:
- Access the web interface at
http://localhost:3000
- Check Docker container status:
docker ps
This should show all three containers running.