Skip to content
Docs
Getting Started

Getting Started

The main goal of Lostdock is to make it easy to deploy and manage Docker Compose stacks on your server. VPS servers are ubiquitous and cheap. They are a great way to host your own services. The biggest problem is orchestration of services. Lostdock solves this problem by providing a simple CLI to deploy and manage Docker Compose stacks.

Installation

npm install -g lostdock

Init a server

Create a new Debian/Ubuntu VPS in your preferred cloud provider. Then init the server:

# After creating a new VPS, login via SSH
lostdock login
 
# Install Docker Compose and start the firewall.
lostdock server init

Deploying

Once you have a server running, you can run a pre-configured stack from GitHub. For example, let's run our lostdock-traefik reverse proxy stack with auto generated TLS certificates

export TRAEFIK_HOST=traefik.example.com
export TRAEFIK_BASIC_AUTH="$(echo $(htpasswd -nb admin admin) | sed -e s/\\$/\\$\\$/g)"
export LETSENCRYPT_EMAIL=example@example.com
 
# Start Traefik reverse proxy
lostdock stacks install-from-git \
    --url https://github.com/carlosbaraza/lostdock.git \
    --path ./packages/lostdock-traefik

We also recommend running the following stacks: lostdock-monitoring (log and metric aggregation and visualization stack) and lostdock-portainer (container management).

Setup new VPS