aboutsummaryrefslogtreecommitdiffstats
path: root/man/bolt-up.1
diff options
context:
space:
mode:
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