diff --git a/README.md b/README.md index e057288..99ccdb4 100644 --- a/README.md +++ b/README.md @@ -70,15 +70,15 @@ Optional, add these later if you want them: ### 1. Get the image -Clone this repository onto your Docker host and build the image locally: +Pull the prebuilt image onto your Docker host: ```bash -git clone alembic -cd alembic -docker build -t alembic:latest . +docker pull git.kretzer.club/andrew/alembic:0.5 ``` -This takes a few minutes the first time. You don't need to touch anything inside the `app/` or `pipeline/` folders, the Dockerfile handles all of it. +That is the whole install. You do not need to download the source or build anything. The `0.5` is the version; you can pin to it so nothing changes under you, or use `latest` to always get the newest. + +(If you would rather build it yourself from source, you can, but you do not need to.) ### 2. Create your folders @@ -131,12 +131,12 @@ In return, it will give you three values you'll need in the next step: ### 5. Write your docker-compose file -Create a `docker-compose.yml` next to your alembic folder: +Create a file called `docker-compose.yml` on your server (put it wherever you keep your other compose files): ```yaml services: alembic: - image: alembic:latest + image: git.kretzer.club/andrew/alembic:0.5 container_name: alembic ports: - "8420:8420" @@ -220,15 +220,15 @@ That's it. On its next scheduled run (or immediately, using the **Run now** butt ## Updating alembic -Pull the latest code, rebuild, and restart: +When a new version is released, change the version in your `docker-compose.yml` (for example `:0.5` to the new number), then pull and restart: ```bash -cd alembic -git pull -docker build -t alembic:latest . -docker compose up -d --force-recreate alembic +docker compose pull +docker compose up -d ``` +If you used the `latest` tag instead of a version number, you can skip the edit and just run those two commands. + Your library, credentials, and settings all live in your mounted folders, so updating the image never touches your data. ## Backups