Skip to content

Commit 36b8c08

Browse files
jolheisertechknowlogick
authored andcommitted
Add migrate command to docs (#8842)
* Add migrate command to docs Signed-off-by: jolheiser <[email protected]> * Link to CLI Signed-off-by: jolheiser <[email protected]> * Clarify idempotence Signed-off-by: jolheiser <[email protected]> * Sneak in convert command Signed-off-by: jolheiser <[email protected]>
1 parent 9395805 commit 36b8c08

File tree

2 files changed

+11
-0
lines changed

2 files changed

+11
-0
lines changed

docs/content/doc/help/faq.en-us.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,7 @@ Also see [Support Options]({{< relref "doc/help/seek-help.en-us.md" >}})
4242
* [SSH Common Errors](#ssh-common-errors)
4343
* [Missing releases after migration repository with tags](#missing-releases-after-migrating-repository-with-tags)
4444
* [LFS Issues](#lfs-issues)
45+
* [How can I create users before starting Gitea](#how-can-i-create-users-before-starting-gitea)
4546

4647

4748
## Difference between 1.x and 1.x.x downloads
@@ -272,3 +273,6 @@ Check the value of `LFS_HTTP_AUTH_EXPIRY` in your `app.ini` file.
272273
By default, your LFS token will expire after 20 minutes. If you have a slow connection or a large file (or both), it may not finish uploading within the time limit.
273274

274275
You may want to set this value to `60m` or `120m`.
276+
277+
## How can I create users before starting Gitea
278+
Gitea provides a sub-command `gitea migrate` to initialize the database, after which you can use the [admin CLI commands]({{< relref "doc/usage/command-line.en-us.md" >}}) to add users like normal.

docs/content/doc/usage/command-line.en-us.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -281,3 +281,10 @@ provided key. You should also set the value
281281
NB: opensshd requires the gitea program to be owned by root and not
282282
writable by group or others. The program must be specified by an absolute
283283
path.
284+
285+
#### migrate
286+
Migrates the database. This command can be used to run other commands before starting the server for the first time.
287+
This command is idempotent.
288+
289+
#### convert
290+
Converts an existing MySQL database from utf8 to utf8mb4.

0 commit comments

Comments
 (0)