Skip to main content

Running Gitea on

· 3 min read
Gitea maintainer

Gitea is designed to run on many different platforms and has very minimal requirements for resources. This is great because whatever computer you have, Gitea can run on it.

Although you might like to self-host your own instance at times, you might not want to manage all of the moving elements of a server, such as firewalls, webservers, TLS certificates, and so on. This is where enters the picture. is a platform with a generous free tier that allows you to tell them the Docker image you want to run and they'll take care of all the tough and time-consuming operational overhead.

To get started, you'll need to sign up for a account. Luckily, they have a nice getting started guide that walks you through the process.

Once you have an account you can get started with running Gitea on

# create a directory to store application config
mkdir gitea-on-fly
# enter into the newly created directory
cd gitea-on-fly
# tell you wish to create a new application in the amsterdam region (there are many other regions you could pick too)
# pick any name for the app that you'd like, in the example we are using `gitea-on-fly`
flyctl launch --name gitea-on-fly --no-deploy --region ams
# give the newely create application persistant storage, so your data persists between app updates
flyctl volumes create gitea_data --size 1 --region ams --app gitea-on-fly

You'll notice that once you've created the app, a new file, named fly.toml, will be created in the directory you just made. This contains a lot of placeholder information, you'll want to replace with the below content. Using the name you picked when you created the application replace gitea-on-fly from the below config in all the places it occurs.

app = "gitea-on-fly"

kill_timeout = 5

image = "gitea/gitea:latest" # latest is the most recent stable release

GITEA__security__INSTALL_LOCK="true" # Don't show installer
# GITEA__service__DISABLE_REGISTRATION="true" # TODO: uncomment once you have created your first user

# persist data
destination = "/data"
source = "gitea_data"

# ssh traffic
internal_port = 22
protocol = "tcp"
port = 22

# https traffic
internal_port = 3000
protocol = "tcp"

handlers = ["http"]
force_https = true
port = 80

handlers = ["tls", "http"]
port = 443

Once you have updated the configuration example with the application name you chose run flyctl deploy, and it will push every up to and deploy your gitea instance.

Now you can visit (or whichever name you chose), and you can create an account and use your Gitea instance.

If you wish to be the only one with an account on your instance, after you've registered you account you can close registrations by uncommenting the environment variable GITEA__service__DISABLE_REGISTRATION, and running flyctl deploy again.

Now that you have a Gitea instance up and running on, you may wish to look into backups, using your own domain name, scaling up RAM/CPU using the cli, or even using's hosted postgres as database instead of sqlite.

An icon showing wave propagation

Join our community

Gitea is open source. Star our GitHub repo, and join our community on Discord!

An icon showing a paper plane

Subscribe to our newsletter

Stay up to date with all things Gitea