NAS Setup Script

An automated script for setting up a Network Attached Storage (NAS) system with various services across multiple Linux distributions.

Legal Notice

Copyright (c) 2025 Sebastian Palencsár

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer: This script is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.

Supported Distributions

• Ubuntu
• Debian
• Fedora
• Arch Linux
• openSUSE

Features

• Automatic Linux distribution detection
• Network configuration (static IP)
• Security setup (Fail2ban, Firewall)
• Docker installation and configuration
• Various services:
  • Samba shares
  • NFS
  • Netdata (system monitoring)
  • Vaultwarden (password manager)
  • Jellyfin (media server)
  • Portainer (Docker management)

Prerequisites

• Supported Linux distribution
• Root access or sudo rights
• Active internet connection
• Minimum 2GB RAM
• Minimum 20GB free disk space

Installation

1. Clone repository:

git clone https://github.com/noordjonge/nasscript.git
cd nasscript

2. Make the script executable:

chmod +x src/setup.sh

3. Run the script:

sudo ./src/setup.sh

Configuration

Network

• Static IP address
• Gateway
• DNS server

Security

• SSH port (default: 39000)
• Fail2ban
• Firewall rules

Services

• Docker data directory
• Samba shares
• NFS exports
• Vaultwarden settings
• Jellyfin media paths
• Portainer configuration

Directory Structure

nasscript/
├── LICENSE
├── README.md
└── src/
    ├── setup.sh
    ├── config/
    │   └── defaults.sh
    └── lib/
        ├── docker.sh
        ├── firewall.sh
        ├── internet.sh
        ├── jellyfin.sh
        ├── logging.sh
        ├── netdata.sh
        ├── network.sh
        ├── nfs.sh
        ├── portainer.sh
        ├── security.sh
        ├── unattended-upgrades.sh
        └── vaultwarden.sh

Usage

1. Run the script with root privileges
2. Follow the on-screen instructions
3. Configure network settings
4. Choose the services to install
5. Wait for the installation to complete

System Requirements

Minimum Hardware Requirements

• CPU: Dual-core processor
• RAM: 2GB minimum, 4GB recommended
• Storage: 20GB for system, additional storage for NAS
• Network: Gigabit Ethernet recommended

Software Requirements

• Clean installation of supported Linux distribution
• systemd-based system
• Internet connection for package downloads
• UEFI or BIOS boot system

Default Ports

• SSH: 39000 (customizable)
• Samba: 139, 445
• NFS: 2049
• Netdata: 19999
• Vaultwarden: 80
• Jellyfin: 8096
• Portainer: 9000

Security Features

• Automatic security updates
• Fail2ban integration
• UFW firewall configuration
• Docker content trust enabled
• Secure shared memory implementation
• SSH hardening

Troubleshooting

Common issues and solutions:

1. Network Configuration

# Check network status
ip addr show
# Verify network configuration
cat /etc/netplan/01-netcfg.yaml

2. Service Status

# Check service status
systemctl status docker
systemctl status jellyfin
systemctl status vaultwarden

3. Firewall Rules

# View firewall status
sudo ufw status
# Check specific port
sudo ufw status | grep 80

Backup Strategy

• Configuration files are automatically backed up before modifications
• Docker volumes should be backed up regularly
• User data requires separate backup strategy
• Recommended: Create periodic snapshots

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Support

If you encounter any issues or have questions, please:

1. Check the Wiki
2. Search existing issues
3. Create a new issue if needed

Author

Sebastian Palencsár

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Thanks to all contributors
• Inspired by best practices in NAS setup and administration
• Built with and for the open source community