Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 0 additions & 13 deletions .pre-commit-config.yaml

This file was deleted.

16 changes: 0 additions & 16 deletions .readthedocs.yaml

This file was deleted.

2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
MIT License

Copyright (c) [year] [fullname]
Copyright (c) 2026 Elijah Anakalea-Buckley/Kupaianaha

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
101 changes: 86 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,91 @@
# Read the Docs – Sphinx Template
# NAS-Setup

A minimal template to spin up documentation quickly.
> Configuration files, scripts, and documentation for setting up and managing a Network Attached Storage (NAS) system.

## Use this template
---

1. Click **Use this template** on GitHub.
2. Clone your new repo and rename placeholders:
## Table of Contents

```bash
export PKG=your_project # snake_case python package directory
export DIST=your-project # distribution/project name in pyproject
rg -l "your_project|your-project|Your Project|Your Name" | \
xargs sed -i '' \
-e "s/your_project/${PKG}/g" \
-e "s/your-project/${DIST}/g" \
-e "s/Your Project/${DIST}/g" \
-e "s/Your Name/Your Name Here/g"
git mv src/your_project src/${PKG}
- [Overview](#overview)
- [Hardware](#hardware)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Configuration](#configuration)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)

---

## Overview

A brief description of your NAS setup — what it's used for, who it's for, and any goals or design decisions behind it.

---

## Hardware

| Component | Details |
|------------|--------------------------|
| Board | e.g. Raspberry Pi 4 |
| CPU | e.g. Quad-core ARM |
| RAM | e.g. 8GB |
| Storage | e.g. 4x 4TB HDD (RAID 5) |
| OS | e.g. TrueNAS / OMV |

---

## Prerequisites

- [ ] List any software or tools required before setup
- [ ] e.g. Docker, SSH access, specific OS version

---

## Installation

```bash
# Clone this repository
git clone https://github.com/your-username/NAS-Setup.git
cd NAS-Setup

# Run setup script (if applicable)
./setup.sh
```

---

## Configuration

Describe the main configuration steps or link to config files in the repo.

```yaml
# Example config snippet
shares:
- name: media
path: /mnt/data/media
read_only: false
```

---

## Usage

Explain how to use the NAS once set up — accessing shares, running scripts, etc.

```bash
# Example: mount a share
mount -t cifs //nas-ip/share /mnt/nas -o username=user
```

---

## Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you'd like to change.

---

## License

[MIT](LICENSE)