55 lines
3.5 KiB
Markdown
55 lines
3.5 KiB
Markdown
---
|
|
title: Aux Wiki
|
|
description: Welcome to the Aux wiki!
|
|
published: true
|
|
date: 2024-05-05T15:31:23.586Z
|
|
tags:
|
|
editor: markdown
|
|
dateCreated: 2024-05-05T14:41:36.200Z
|
|
---
|
|
|
|
<p align="center">
|
|
<a href="https://forum.aux.computer/c/special-interest-groups/sig-documentation/21"><img src="https://img.shields.io/static/v1?label=Maintained%20By&message=SIG%20Documentation&style=for-the-badge&labelColor=222222&color=794AFF" /></a>
|
|
</p>
|
|
|
|
# Welcome to the Aux Wiki!
|
|
|
|
Welcome to the official documentation for Auxolotl. You can view this Wiki online at [wiki.axolotl.org](<https://wiki.auxolotl.org>), or see our source code [on GitHub](<https://github.com/auxolotl/wiki>)
|
|
|
|
If you're new to Auxolotl and want to jump right in, check out the Getting Started guide.
|
|
|
|
> If you have any questions, comments, or suggestions for how we can improve docs, please contact the SIG-DOCS team on [Discourse](https://forum.aux.computer/c/special-interest-groups/sig-documentation/21).
|
|
|
|
## What is Auxolotl?
|
|
|
|
Auxolotl is a community-driven fork of [Nix](https://nixos.org/), a package manager and Linux distro (distribution) designed around declarative, reproducible builds. Unlike other distros, Nix lets you define your entire system's configuration in plain text files, making it easy to modify, rebuild, and share system configurations.
|
|
|
|
## How do I get started with Auxolotl?
|
|
|
|
Check out our Getting Started guide, or if you want to jump right in, [download a template for quickly bootstrapping a system with Auxolotl](https://github.com/auxolotl/templates).
|
|
|
|
## How is Auxolotl different from Nix/NixOS?
|
|
|
|
Currently Auxolotl and Nix are intercompatible: i.e., you can install Nix packages in Auxolotl, and vice versa. You can also easily switch between both distros. Auxolotl's compatibility with Nix may change as development continues.
|
|
|
|
## Who is Auxolotl for?
|
|
|
|
The short answer is: Auxolotl is for everyone.
|
|
|
|
Auxolotl is for users who like having declarable, reproducible systems. With Auxolotl, your entire system configuration is defined in plaintext files, which you can easily edit, copy, and share. This makes for systems that are easier to customize and harder to break than traditional distros. However, this does mean Auxolotl has a learning curve: Auxolotl uses a language with a unique syntax, package management is different than in most distros, and most system configuration is done using [options](https://search.nixos.org/options). To lower this barrier to entry, Auxolotl comes with [templates to help you quickly get started and bootstrap your first system](https://github.com/auxolotl/templates).
|
|
|
|
You don't need to be a software developer or experienced system administrator to use Auxolotl, but we recommend that you have some experience using command-line tools, text editors like Vim and Nano, and at least a basic understanding of the Linux ecosystem.
|
|
|
|
## Why was Auxolotl created?
|
|
|
|
==TODO==
|
|
|
|
## Who's behind Auxolotl?
|
|
|
|
Auxolotl is a [community-driven distribution](https://github.com/auxolotl/community) originally forked from Nix by [Jake Hamilton](https://github.com/jakehamilton). The team is organized into distinct Special Interest Groups (SIGs) covering separate parts of Auxolotl, such as package maintainers, documentation maintainers, community moderators, etc. If you'd like to contact or join the team, you can do so on the [Auxolotl community forums](https://forum.aux.computer/).
|
|
|
|
## Links
|
|
|
|
- [Auxolotl community forums](https://forum.aux.computer/)
|
|
- [Auxolotl GitHub](https://github.com/auxolotl)
|
|
- [Auxolotl system templates](https://github.com/auxolotl/templates) |