Guide for managing and debugging Docklift containers and deployments.
Docklift is a container management platform, so understanding the underlying Docker operations is crucial.
The main Docklift platform consists of exactly 4 containers (defined in docker-compose.yml):
| Container | Port | Purpose |
|---|---|---|
docklift-backend |
8000 (internal) | Express API server |
docklift-frontend |
3000 (internal) | Next.js dashboard |
docklift-nginx |
8080:80 | Dashboard gateway (routes to frontend + backend) |
docklift-nginx-proxy |
80:80 | Custom domain proxy for user-deployed apps |
Note: There is NO
docklift-dbcontainer. SQLite is a file (/app/data/docklift.db) inside the backend container.
docker logs docklift-backend -f --tail 100
docker logs docklift-frontend -f --tail 100
docker logs docklift-nginx -f --tail 100
docker logs docklift-nginx-proxy -f --tail 100
Navigate to /logs in the Docklift dashboard. This provides real-time SSE-streamed logs with:
User deployments follow the naming convention: dl_<shortId>_<serviceName>.
# List all user containers
docker ps --filter "name=dl_"
# View logs for a specific user container
docker logs dl_2d165805_app -f
docker inspect <container_name_or_id>
docker logs <container_name_or_id>
docker exec -it <container_name_or_id> /bin/sh
All Docklift containers + user deployments are on the docklift_network bridge network.
# Inspect the network
docker network inspect docklift_network
| Host Path | Container Path | Used By |
|---|---|---|
./data |
/app/data |
Backend (SQLite DB) |
./deployments |
/deployments |
Backend (project files) |
./nginx-proxy/conf.d |
/nginx-conf |
Backend (generates proxy configs) |
./backups |
/data/backups |
Backend (DB backups) |
# Clean up unused resources (careful in production!)
docker system prune -a
Docklift also has built-in purge APIs at /api/system/purge/*.