This section should cover everything a "newbie" user needs to get started. It is recommended that you use the RoninOS images, but we will always try to support Manjaro ARM XFCE. Use the videos below for visual aid or skip right to the instructions in text form. If you need help please reach out in the RoninDojo chatroom.
Windows10 users can view the Windows10 Video Playlist for help as they follow this guide.
PGP Keys Wiki or PGP Keys Webpage
Flashing OS to Micro SD Card Example Video
Choose an image to download for your device from the download section above. RoninOS is customized Manjaro ARM Minimal for RoninDojo users, but we will always try to support the official Manjaro ARM XFCE releases if you prefer to use them instead.
It is recommended that you verify this image using using gpg. If you are unsure about verifying please watch this video, playlist, or read this article.
Once you have downloaded the image on your computer, you need to flash it on an SD card. Download and install Balena Etcher. It’s a tool to flash an Operating System image to a micro SD card.
Start Etcher, make sure your micro SD card is plugged in to your PC, and then select the image file corresponding to Manjaro. An example is Manjaro-ARM-RoninOS-rpi4-XX.XX.img.xz.
Finally click on “Flash!” to start the SD card flashing. After a few minutes, the SD card is ready. You can eject it.
Manjaro ARM Configuration Example Video
Insert the now flashed SD card into your device, make sure the SSD is plugged, and power on the device.
Remote login to your device to configure your Operating System. This can be done from any Linux, Windows, or Mac computer that is connected to your local network using the following command:
ssh root@192.168.X.X
If you are not familiar with SSH command above, please see the SSH help section first.
Enter the username you want to use and confirm. Next you can add additional groups for additional users, but leave it blank for now.
Then, you need to answer the following questions:
User
Name
User password
Root password (Root user available)
Timezone
» You can use this site to help with selecting your correct timezone.
Locale
» Locale names are typically in the form of:
language[_territory][.codeset][@modifier]
» For example, en_US.UTF-8 for American-English
» For more info reference:
ArchLinux Locale
Keyboard layout
» There's a multitude of keyboard layouts, choose US for standard English keyboard.
» For more info reference:
ArchLinux Keyboard Configuration
Device host name
Finally, the wizard gives you a list of all the information entered above. Confirm if everything is OK.
The basic configuration takes a few seconds. Then the system resizes the SD card partition and reboots. After the reboot, the system is ready to use with your settings.
Once completed, SSH remote login with your new username.
Example:
ssh username@192.168.X.X
An ethernet connection is really the best way to get Internet access. If you have used Wifi and it is stable please feel free to submit a guide.
SSH Remote Login Example Video
We find it best to use SSH for remote login from any device that is on the same local network as your RoninDojo. This way you can avoid the hassle of plugging in a monitor and keyboard to your RoninDojo.
You can use the following options:
Ubuntu Windows Subsystem - (video)
Putty Putty.org
Termux Google Play store
ConnectBot Google Play store
For system setup:
ssh root@192.168.X.X
Once system setup is completed:
ssh username@192.168.X.X
Once the Operating System is setup, you are ready to begin the RoninDojo install process. Below are a few basic commands and we recommend you consult ArchLinux Pacman/Rosetta below for more.
To install a new package:
pacman -S < package >
To search a package name:
pacman -Ss < search >
To update the system:
pacman -Syu
The net-tools package is installed during the RoninDojo system setup script.
ifconfig command is not available by default, you need to install it with:
pacman -S net-tools
Now you can use it by typing:
ifconfig
For more commands reference:
ArchLinux Pacman/Rosetta
Check out the Troubleshooting page for more info.
Need help? Join the RoninDojo Chatroom.