Skip to content
/ armnas Public

NAS dashboard for Raspbian/Armbian devices. 5 minutes to install.

License

Notifications You must be signed in to change notification settings

h4570/armnas

Repository files navigation

Raspbian ARM32 Hardkernel odroid Debian x64 ARM64  i18n EN i18n PL  5 minutes install

showcase

Armnas

Simple NAS web dashboard designed for ARM devices
Installation guide »

Report Bug · Request Feature

Stargazers repo roster for h4570/armnas

Table of Contents

About the Project

Description

Armnas is a lightweight web NAS dashoard designed for ARM devices. It was created for people who do not want to install another operating system in order to have a NAS dashboard. The installation script is very simple and the average installation time is around 5 minutes. Uninstallation is even easier and takes less than 1 minute. With Armnas, you can buy a Raspberry Pi, a portable drive and enjoy a home NAS for <$100 dollars. Every release is tested on Raspberry pi 4 (Raspbian ARM32), Odroid XU4 (Armbian ARM32) and VMWare (Debian x64).
Languages: English, Polish.

CI Coverage Status License .NET 6.0.2 Angular 11

Features list

Branches

  • main: main releases - tested on Armbian (ARM32), Raspbian (ARM32) and Debian x64.
  • develop: daily builds - can be unstable.

Installation

If you want to install armnas, please run theses two commands:
sudo wget https://raw.githubusercontent.com/h4570/armnas/main/install.sh
sudo chmod +x install.sh && sudo ./install.sh
If you want to get more details about installation/uninstallation and update procedure, please go to Installation guide.

Features

System info

System information with latest CPU temperature, RAM usage, etc.
Refresh interval can be set in Tweak mode.
System info

Partitions

Partitions module is used to mount/unmount your HDDs, pendrives, etc. very quickly.
Partitions can be also set in automount mode, which will mount you partitions at startup.
Custom names of the partitions can be set in Tweak mode.
Partitions

Cron

Cron jobs allows you to schedule your custom commands, programs or bash scripts.
Cron

Samba

Samba is used to share some directories or mounted partitions via SMB protocole. You can easily mount these shares in your Windows machine.
Samba
Samba shares

Transmission

Transmission is a simple torrent client with web dashboard.
Incomplete directory and complete directory can be set in Tweak mode.
Transmission

Messages

Messages system is used to add notifications directly from your bash scripts, programs and bash terminal.
For example, you can create backup script and send the result (success/fail) to Armnas. After it, Armnas will show new notification in navbar area for you.
Please check Messages to get more details.
Messages

Keycloak

Keycloak is an Open Source Identity and Access Management solution for modern Applications and Services.
More information

Development

Armans actively uses bash to execute commands on the target system. To facilitate the development of Armnas, an SSH module has been added. There is logic in the code that checks the current system. When it is Windows, Armnas automatically tries to execute commands on target system via SSH.
Please check Development guide to get more details.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/amazing-feature)
  3. Commit your Changes (git commit -m 'Add some amazing-feature'), please try to use commit in Angular commit convention style
  4. Push to the Branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Application logs

When you encounter a problem in the application, you can double-check what happened in the log file.
This file is located in: /var/www/armnas/backend/WebApi/webapi.log
The file is cleaned before each Armnas backend run!

Questions and answers

You can find list of the most common problems in Questions and answers file.

Translation

If you want to contribute and translate Armans to another language, here is the todo list.

  1. Create file with your language translations in: /frontend/web-app/src/assets/i18n/xx_XX.json
  2. Add translation for name of your language in (navbar->language): /frontend/web-app/src/assets/i18n/xx_XX.json and other languages
  3. Add button with your language in (line 87): /frontend/web-app/src/app/components/navbar/navbar.component.html

License

Distributed under the Apache License 2.0 License. See LICENSE for more information.

Built With

Project Link: https://github.com/h4570/armnas
Sandro Sobczyński - [email protected]
LinkedIn