# Create a Github Repo and Deploy Your Flake on Flakery
In this tutorial, we will create a basic NixOS flake and deploy it on Flakery.
# Prerequisites
Before you begin, you will need to have the following installed:
This guide also assumes that you have Github (opens new window) account.
This guide also assumes that you have in your current directory a nix flake defining a NixOS configuration hello-flakery. Adjust this to suit your situation and refer to these examples from the nix flake man page (opens new window)
# Create a git repository and push your flake
Initialize a git repository and create an initial commit.
git init
git add .
git commit -m "initial commit"
2
3
Create a new repository on GitHub (opens new window) and push your flake to the repository.
git branch -M main
git remote add origin git@github.com:getflakery/basic-flake.git
git push -u origin main
2
3
TIP
Replace git@github.com:getflakery/basic-flake.git with your repository URL.
Now that you have created a flake and pushed it to a git repository, you can deploy it on Flakery.
# Deploy your Nixos Flake on Flakery
To deploy your flake on Flakery, you will need to create a new deployment. You can do this by visiting the Flakery website (opens new window) and adding your flake to the input field. the url should look something like this: github:$YOUR_USERNAME/basic-flake#hello-flakery.
TIP
Replace $YOUR_USERNAME with your Github username.
Once you have added your flake, it will appear in the list of available flakes. You can click on the flake to view its details.
Once you have added your flake, you can click the "Create Deployment" button. This will create a new deployment of your flake.
after creating your deployment, you can view the details of your deployment.
After a few minutes, your deployment will be ready. You can then browse to the URL of your deployment to view your NixOS system.