How to install Gogs on nixOS Latest

Gogs is an easy-to-use self-hosted git service that is lightweight and efficient, and it can be installed on nixOS Latest system at ease.

This tutorial provides you with a step-by-step guide to install Gogs on nixOS Latest.

Prerequisites

  • A nixOS Latest system ready.
  • Root access to the system.
  • A non-root user with sudo privileges.

Step 1 - Update the system

Before proceeding with the installation, update your system to the latest package versions:

sudo nix-channel --update
sudo nixos-rebuild switch

Step 2 - Install NixShell

Install NixShell first:

sudo nix-env -iA nixpkgs.nixUnstable

Step 3 - Install Gogs

Install Gogs on your system by running the following command:

sudo nix-shell -p gogs --run "gogs install"

This command will automatically install all the necessary components and dependencies to run Gogs.

Step 4 - Configure Gogs

After the installation is complete, you need to configure Gogs to set up all the necessary settings to run it.

Open the Gogs configuration file at /var/lib/gogs/conf/app.ini:

sudo nano /var/lib/gogs/conf/app.ini

Set the necessary configuration options as per your requirement. Make sure to update the HTTP section with your server's IP address or domain name.

Example:

[server]
PROTOCOL = http
DOMAIN   = <YOUR DOMAIN>
HTTP_PORT = 3000
ROOT_URL = http://<YOUR DOMAIN>:3000/
...

Save the changes and exit.

Step 5 - Start Gogs

To start Gogs, run the following command:

sudo systemctl start gogs

Step 6 - Access Gogs

Access Gogs by going to http://YOUR_SERVER_IP:3000 in a web browser.

You will be redirected to the Gogs login page, where you can create a new user account and start using Gogs.

Note: You may need to open the firewall port 3000 to access the Gogs web interface:

sudo firewall-cmd --add-port=3000/tcp --permanent
sudo firewall-cmd --reload

Conclusion

You have successfully installed Gogs on nixOS Latest. Now you can self-host your Git repositories using Gogs on your server.