Code and content for the nixos.org website.

There are many ways how you can help:

• if you are familiar with CSS look at the issues tagged with design tag.
• if you are an native English speaker or just a person that is very good with words, please look at the issues tagged with content tag
• if you are developer and just eager to fix stuff please look at the issues tagged with bug tag

If you feel lost where and how to contribute, ask the marketing team on the #marketing room on Matrix.

To run local development instance follow this steps to start a local server

$ git clone [email protected]:NixOS/nixos-homepage.git
$ cd nixos-homepage
$ nix-shell

  To start developing run:
      serve

  and open browser on:
      https://localhost:8000

  It will rebuild the website on each change.

[nix-shell]$ serve

If you have Docker and Docker Compose installed, you can alternatively run

$ docker-compose up

Once everything's ready, you'll be able to access

Open your browser at: http://localhost:8000/

In order for the browser to automatically refresh, install the Livereload extension for your browser.

Before creating a pull request make sure that nix-build runs successfully.

It can take some time to enter the development environment. To speed up and avoid building from source, you can use a binary cache. The same cache is used to speed up our GitHub Actions.

Add the following to your configuration.nix:

nix.binaryCaches = [ "https://nixos-homepage.cachix.org" ];
nix.binaryCachePublicKeys = [ "nixos-homepage.cachix.org-1:NHKBt7NjLcWfgkX4OR72q7LVldKJe/JOsfIWFDAn/tE=" ];

Add the following to the /etc/nix/nix.conf or ~/.config/nix/nix.conf:

substituters = ... https://nixos-homepage.cachix.org
trusted-public-keys = ... nixos-homepage.cachix.org-1:NHKBt7NjLcWfgkX4OR72q7LVldKJe/JOsfIWFDAn/tE=

The content of the website is licensed under the Creative Commons Attribution Share Alike 4.0 International license.

The software (including sample code) is licensed under the MIT license.

Some files might have a different license. See the files content for details.