aboutsummaryrefslogtreecommitdiffstats
path: root/man/bolt-up.1
diff options
context:
space:
mode:
authorEugene Triguba <hello@eugenetriguba.com>2026-02-12 19:14:17 -0500
committerEugene Triguba <hello@eugenetriguba.com>2026-02-12 19:14:17 -0500
commit449f74ded67b49fb3066d6d107fa6de9dba0093c (patch)
treed18017e8e318541781d5cf1cb3e161d3c2ee0be8 /man/bolt-up.1
parentRelease v0.12.1 (diff)
downloadcli-449f74ded67b49fb3066d6d107fa6de9dba0093c.zip
Replace HTML docs with man pages that ship with bolt
Diffstat (limited to 'man/bolt-up.1')
-rw-r--r--man/bolt-up.145
1 files changed, 45 insertions, 0 deletions
diff --git a/man/bolt-up.1 b/man/bolt-up.1
new file mode 100644
index 0000000..c8729b4
--- /dev/null
+++ b/man/bolt-up.1
@@ -0,0 +1,45 @@
+.Dd February 12, 2026
+.Dt BOLT-UP 1
+.Os
+.Sh NAME
+.Nm bolt-up
+.Nd apply migrations against the database
+.Sh SYNOPSIS
+.Nm bolt up
+.Op Fl v Ar version
+.Op Fl -version Ar version
+.Sh DESCRIPTION
+.Nm
+applies pending migrations to the database. Migrations are executed in
+dependency order as determined by the
+.Ql -- depends:
+directives in each migration file.
+.Pp
+By default, all pending migrations are applied. Use the
+.Fl v
+option to apply migrations up to and including a specific version.
+.Pp
+Each migration runs within a transaction by default, ensuring that if any
+statement fails, the entire migration is rolled back. See
+.Xr bolt-execution 7
+for details on transaction behavior.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl v Ar version , Fl -version Ar version
+Apply migrations up to and including the specified version. If not provided,
+all pending migrations are applied.
+.El
+.Sh EXIT STATUS
+.Nm
+exits 0 on success, and >0 if an error occurs.
+.Sh EXAMPLES
+Apply all pending migrations:
+.Dl $ bolt up
+.Pp
+Apply migrations up to a specific version:
+.Dl $ bolt up -v 20240316145038
+.Sh SEE ALSO
+.Xr bolt 1 ,
+.Xr bolt-down 1 ,
+.Xr bolt-status 1 ,
+.Xr bolt-execution 7