Table of Contents
Everything I need to not forget. Deployed to:
If you're reading this, sorry, registration is deactivated.
Ubuntu Docker Setup
Deployment
On Digital Ocean, choose a droplet with Docker already installed. The $6/month plan is enough for a low stress scenario.
Follow the official guide.
Unfortunately, as of now it still uses the old version of docker compose, docker-compose instead of docker compose. I will use the new version.
To start the app container, run:
sudo docker compose -f ./deploy-compose.yml up -d
To stop the container, run:
docker compose -f ./deploy-compose.yml down
Manual Update Instructions (For Forked Repo with Upstream)
Fetch latest changes from the original repo.
git fetch upstream
Update the local main branch
git checkout main
git merge upstream/main
Rebase your custom branch onto the updated main branch to incorporate the latest changes.
git checkout librechat-domain
git rebase main
If conflicts occur (e.g., in
nginx.conf):# Resolve conflicts manually, then: git add client/nginx.conf git rebase --continue
Push updates to your forked repository. Use --force-with-lease to avoid overwriting changes.
git push origin main
git push --force-with-lease origin librechat-domain
Update the Docker containers. Stop Containers (No Data Loss):
docker compose -f deploy-compose.yml down
Clean old images (optional):
docker images -a | grep "librechat" | awk '{print $3}' | xargs docker rmi
Pull latest images:
docker compose -f deploy-compose.yml pull
Start LibreChat:
docker compose -f deploy-compose.yml up -d
Verify the update:
docker ps # Check containers are running
curl -I http://localhost:80 # Or the domain