Simple NAS web dashboard designed for ARM devices
Installation guide »
Report Bug
·
Request Feature
- About the Project
- Installation
- Features
- Development
- Contributing
- Application logs
- Questions and answers
- Translation
- License
- Built With
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.
- System info
- Quick unmount/mount of partitions
- Partitions automount (on startup)
- Samba configuration
- Torrent client (transmission)
- Cron jobs configuration
- Messages system
- Keycloak (optional)
- main: main releases - tested on Armbian (ARM32), Raspbian (ARM32) and Debian x64.
- develop: daily builds - can be unstable.
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.
If you want to uninstall armnas, please run theses two commands:
sudo wget https://raw.githubusercontent.com/h4570/armnas/main/uninstall.sh
sudo chmod +x uninstall.sh && sudo ./uninstall.sh
System information with latest CPU temperature, RAM usage, etc.
Refresh interval can be set in Tweak mode.
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.
Cron jobs allows you to schedule your custom commands, programs or bash scripts.
Samba is used to share some directories or mounted partitions via SMB protocole. You can easily mount these shares in your Windows machine.
Transmission is a simple torrent client with web dashboard.
Incomplete directory and complete directory can be set in Tweak mode.
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.
Keycloak is an Open Source Identity and Access Management solution for modern Applications and Services.
More information
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.
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.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/amazing-feature) - Commit your Changes (
git commit -m 'Add some amazing-feature'), please try to use commit in Angular commit convention style - Push to the Branch (
git push origin feature/amazing-feature) - Open a Pull Request
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!
You can find list of the most common problems in Questions and answers file.
If you want to contribute and translate Armans to another language, here is the todo list.
- Create file with your language translations in:
/frontend/web-app/src/assets/i18n/xx_XX.json - Add translation for name of your language in (navbar->language):
/frontend/web-app/src/assets/i18n/xx_XX.jsonand other languages - Add button with your language in (line 87):
/frontend/web-app/src/app/components/navbar/navbar.component.html
Distributed under the Apache License 2.0 License. See LICENSE for more information.
Project Link: https://github.com/h4570/armnas
Sandro Sobczyński - [email protected]
