{"id":170,"date":"2022-04-26T22:54:00","date_gmt":"2022-04-26T20:54:00","guid":{"rendered":"https:\/\/bowfinger.de\/blog\/?p=170"},"modified":"2022-04-26T21:20:25","modified_gmt":"2022-04-26T19:20:25","slug":"lost-gitea-local-admin-password","status":"publish","type":"post","link":"https:\/\/bowfinger.de\/blog\/2022\/04\/lost-gitea-local-admin-password\/","title":{"rendered":"Lost Gitea Local Admin Password?"},"content":{"rendered":"\n

There are various possible ways you can lose access to your Gitea instance. In particular, if you are getting user accounts via LDAP, you should always have a key to get back in: a “local” admin.<\/p>\n\n\n\n

In case you haven’t got one (totally not like I did definitely only once \ud83e\udd2b), deleted it or lost its password, here’s the procedure in to variants: running on plain Linux, and running within Docker.<\/p>\n\n\n\n

Plain Linux<\/h2>\n\n\n\n

List the available (local) user accounts (you may need to run this with sudo<\/code>):<\/p>\n\n\n\n

$ gitea admin user list\n\nID   Username     Email             IsActive IsAdmin\n1    user1        me@home.earth     true     false<\/code><\/pre>\n\n\n\n
You may not get a single user listed here. In order to add a local administrator, do this<\/p>\n\n\n\n
$ sudo gitea admin user create --username local_admin --email admins@email.earth --admin --random-password\n\ngenerated random password is 'IzgvOwv1M9EG'\nNew user 'local_admin' has been successfully created!\n\n$ sudo gitea admin user list\n\nID   Username     Email                 IsActive IsAdmin\n1    unpriv_local bowfingermail@gmx.net true     true\n3    local_admin  admins@email.earth    true     true<\/code><\/pre>\n\n\n\n
Especially on shared machines, I’d strongly recommend not setting a password via the command line. It’ll stick in bash_history<\/code> and may be visible in the process list. Hence the --random-password<\/code> option here. Use the generated password upon first login in the browser.<\/p>\n\n\n\n
Docker Container<\/h2>\n\n\n\n
In order to get to the “plain Linux” field, you simply run a bash<\/code> in the Gitea Docker container.<\/p>\n\n\n\n
What’s the container’s name? Get it via docker container ls -a<\/code>. Let’s say it’s called gitea<\/code>. To start bash in that container, do<\/p>\n\n\n\n
user1@linux:$ docker exec -it gitea \/bin\/bash<\/code><\/pre>\n\n\n\n
Now, you basically do the same thing as in the section above.<\/p>\n\n\n\n
docker # gitea admin user list\n\nID   Username     Email             IsActive IsAdmin\n1    user1        me@home.earth     true     false\n\ndocker # gitea admin user create --username local_admin --email admins@email.earth --admin --random-password\n\ngenerated random password is 'ikV6xzPTiH7B'\nNew user 'local_admin' has been successfully created!\n\ndocker # gitea admin user list\n\nID   Username     Email                 IsActive IsAdmin\n1    unpriv_local bowfingermail@gmx.net true     true\n3    local_admin  admins@email.earth    true     true<\/code><\/pre>\n\n\n\n
Conclusion (and Other Platforms)<\/h2>\n\n\n\n
The Plain Linux approach works equally well on other platforms. I hope this helps.<\/p>\n","protected":false},"excerpt":{"rendered":"
There are various possible ways you can lose access to your Gitea instance. In particular, if you are getting user accounts via LDAP, you should always have a key to get back in: a “local” admin. In case you haven’t got one (totally not like I did definitely only once \ud83e\udd2b), deleted it or lost…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[16,1],"tags":[34,33,32,18],"class_list":["post-170","post","type-post","status-publish","format-standard","hentry","category-linux","category-uncategorized","tag-admin","tag-docker","tag-gitea","tag-linux"],"_links":{"self":[{"href":"https:\/\/bowfinger.de\/blog\/wp-json\/wp\/v2\/posts\/170","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bowfinger.de\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/bowfinger.de\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/bowfinger.de\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/bowfinger.de\/blog\/wp-json\/wp\/v2\/comments?post=170"}],"version-history":[{"count":8,"href":"https:\/\/bowfinger.de\/blog\/wp-json\/wp\/v2\/posts\/170\/revisions"}],"predecessor-version":[{"id":232,"href":"https:\/\/bowfinger.de\/blog\/wp-json\/wp\/v2\/posts\/170\/revisions\/232"}],"wp:attachment":[{"href":"https:\/\/bowfinger.de\/blog\/wp-json\/wp\/v2\/media?parent=170"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/bowfinger.de\/blog\/wp-json\/wp\/v2\/categories?post=170"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/bowfinger.de\/blog\/wp-json\/wp\/v2\/tags?post=170"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}