RedditBot/DOKPLOY_DEPLOY.md

Deploying RedditBot to Dokploy

This guide explains how to deploy the RedditBot to Dokploy without needing to manually transfer your local browser session.

Automated Login Feature

The bot has been updated to support automated login using environment variables. This means when you deploy to a fresh server (like Dokploy), the bot will detect it's not logged in and automatically authenticate using the credentials you provide.

Deployment Steps

1. Create a New Application in Dokploy:

   • Select "Docker Compose" as the deployment method (recommended) or "Dockerfile".

2. Environment Variables:

   • Go to the "Environment" tab of your application.
   • Add the following variables:
     • OPENROUTER_API_KEY: Your OpenRouter API key.
     • REDDIT_USERNAME: Your Reddit username.
     • REDDIT_PASSWORD: Your Reddit password.
     • BROWSER_HEADLESS: true (Important for server environments).

3. Volumes (Persistence):

   • The docker-compose.yml is already configured to mount a ./data volume.
   • Dokploy usually handles volumes automatically for Docker Compose projects, or you may need to define a persistent volume path if you want data to survive container recreations (which you do, to avoid logging in every time).
   • Make sure the /app/data directory is persisted.

4. Deploy:

   • Push your code to your Git repository connected to Dokploy.
   • Click "Deploy".

How it works

1. On the first run, the bot will see the data/browser-session folder is empty/invalid.
2. It will read REDDIT_USERNAME and REDDIT_PASSWORD.
3. It will launch a headless browser, navigate to Reddit, and log in.
4. The session cookies and storage will be saved to data/browser-session.
5. On subsequent restarts, it will use the saved session (as long as the /app/data volume is persisted).

Troubleshooting

• Login Failed: Check the application logs. If Reddit presents a captcha or 2FA, the automated login will fail. You may need to temporarily run locally to solve the captcha, then copy the session (though this feature avoids that for standard accounts).
• Verification: The logs will show "Credentials found in config/env. Attempting automated login..." followed by "Login successful!".