FAQ - Frequently Asked Questions
Here are a few of the most frequently asked questions we have received over time. Please contact us if you find that some need clarification, updating, or you find there is some question missing.
- Requirements 4 questions
- General 38 questions
- Configuration 8 questions
- Installation 16 questions
- Apps 8 questions
- Usage - general 3 questions
- Usage - networking 7 questions
- Usage - file sharing 7 questions
- Usage - VPN 1 questions
- Amahi Sync 3 questions
- Running your HDA 3 questions
- App Packaging 3 questions
Requirements
» Does Amahi support PowerPC architectures?
» What architectures/systems does Amahi support?
- PCs with a 32-bit x86 processor
- PCs with a 64-bit x86-64 processor
- Plug Computers based on the Marvell Plug Computer architecture. This edition of Amahi uses a different install method. See the Amahi Plug Edition
» What are the minimum requirements to run Amahi?
- 512MB or more of RAM
- A 1GHz 32-bit or 64-bit processor
- 4GB disk
For the Amahi Plug Edition the requirements are:
- A Marvell Plug Computer
- 256 MB RAM (512 strongly recommended)
- 2GB storage
- 1.2GHz or faster
No flash storage is used by default on ARM.
» What is the best format for a hard drive to be used in Amahi?
For the Operating System, we recommend the default, ext4, which is a native Linux file system.
For mounting drives with your data, we also recommend ext4. However you can use many other file systems, like FAT and NTFS. These may come with some loss of functionality like permissions, file sizes or journaling.
General
» How is Amahi pronounced?
:-)
» What is an HDA? What does it stand for?
» Where is the Amahi data stored?
/var/hda on your system.
» Does Amahi support RAID?
» Does Amahi support Ubuntu?
» Does Amahi support wireless networks?
» Is the HDA supposed to be the DHCP/DNS server for my home network?
» Do you support CentOS?
- CentOS is permanently behind, by its very nature. This is good, in the name of stability. By the time CentOS rolls around to a new version, Amahi would have been stuck in old libraries and packages for a long long while.
- We have tested CentOS (5 and later), however, it needs a lot of packages and infrastructure dependencies to make it work. There are dozens of small details that break apps in subtle ways, which makes it hard to support it thoroughly. There is a lot more to it than meets the eye: package names are slightly different, deps are just a little different, some files have different paths in CentOS, ....
- There is limited support for non-x86 platforms. We would like to at least not loose ARM.
- CentOS's focus seems to be enterprise-centric, so, many multimedia and other leading-edge libraries and packages are either not there, very old, or have subtle issues. Amahi has to walk a like between being stable and being up to date and on the leading edge. It's not a great alignment of interests with CentOS.
- Finally, the CentOS community is ... in short ... not friendly. The Amahi community tried to interact with them and they are very abrasive. Their focus is IT and stability and not modern libraries and stacks like Ruby on Rails, etc. The Fedora and Ubuntu communities are more welcoming to Amahi. We also have been able to maintain some packages for them.
» Do you support iTunes?
» Do you have a UPnP or DLNA server? Xbox, Xbox360 or PS3?
» How do I download Amahi?
» What are the system requirements to install Amahi?
» What does Amahi mean?
» Why do I have to sign up? What do I get for signing up?
» Does Amahi require to be running as a DHCP server?
- Use your HDA's DHCP and caching DNS server: This is the recommended configuration to have the all the features of the apps that come with Amahi.
- Use only your HDA's caching DNS server: To do this, change the DNS that your router gives out in the DHCP requests (or change your clients) to your HDA's IP address. By pointing your router DNS to the IP address of the Amahi HDA you will get a lot of
the functionality all of the machines in your
network that use it.
With this setup, everything will work, except:
- Assigning of static IPs in your network settings will not work
- PBA (Personal backup assistant) will work, except you will not be able to network boot your systems. Use the SystemRescueCD boot option.
- Automatic DHCP naming of machines in your network will not work (the Amahi DHCP is configured to automatically allocate DNS names for machines that request their name via DHCP).
- Your Amahi HDA-provided domain will not work inside your own network. This means short URLs will not work in this configuration. Please use the long form url (with the full domain name you chose for your network).
- No change in DHCP or DNS in your router: You can use the desktop in your HDA and do most every features on your Amahi HDA, as the HDA will use its own DNS server. Other machines in the network will not take advantage of most features in the the Amahi HDA. They will probably see the file server in the HDA, though it may only be accessible with an IP address, not a name. The AmahiiTunes server and UPnP server may be visible to clients, however, this is not tested/supported.
» Does Amahi provide NAS funcionality?
» How do I install Amahi?
» Privacy: Does Amahi have any connections to the internals of my network?
» Is Amahi supported in my language?
» Does Amahi work with the Smoothwall firewall
Smoothwall is not available as a one-click install today.
In the future, it may be packaged by someone in the community, however, our philosophy is "It's your box!" so you can definitely go into your Amahi HDA and install it.
The one suggestion is to use eth1 for the WAN device, and that will probably make installation in Amahi easier.
» Why do I need an Install Code to get my server installed?
» Does Amahi come fully loaded with the LAMP stack (Linux, Apache, MySql, and PHP)?
Absolutely!
The majority of Amahi apps are LAMP apps. So, all the components to run LAMP apps are present in Amahi from the get go!
In addition, Amahi provides a most excellent development environment for LAMP as well as all the other major frameworks like RoR (Amahi itself if built in RoR), Python, etc. etc.
Wether you do it as a hobby, for learning or professionally, Amahi is a great development environment for the most up to date technologies.
» What is this error about? "There are no applications available at this time"
This error is an indication of two possible things: a) your HDA does not have network connectivity b) you installed an unsupported version of Amahi.
If you have network connectivity, it may be that you installed a version of Amahi that is too old or too new. Amahi usually stays a bit behind new major releases, due to stability considerations and also due to the development team being small.
» I used the wrong domain name for the install ... Any way to reinstall with the name I really want without doing a full reinstall?
There is no good way to do this, unfortunately, so it's not officially supported. The domain information gets populated all over the place in configuration files as your HDA gets used. The best solution is to reinstall.
However, if you just installed and have no apps installed or have not done much, you can probably get away with it by doing these steps, only for advanced users:
- Uninstall all apps and themes
- Create a new profile in your control panel with the same settings, but with the new domain. This will give you a new install code.
- In your HDA, bring up a terminal with root access (or ssh into your HDA if you do not have console).
- Remove a file with this:
rm /etc/sysconfig/amahi-hda - Run this command:
hda-new-install -f NEWINSTALLCODE(replacing the NEWINSTALLCODE with your new install code you obtained above)
Again, this is not really fully supported.
» I did not receive an activation email!
Amahi emails are sent with dual signatures. Most likely the email was sent out successfully. Here are some ideas and how to re-generate the activation email.
- Did you check your spam folder?
- Did you accidentally delete it?
- Does your provider reject emails with unique links?
If you would like to re-send the activation email, you can do so by entering your email in the forgot password page and your will receive an email with your activation link (or your reset password link if you somehow already activated).
Otherwise please contact support for help.
» How hard it is to convert from WHS to Amahi?
If you are using the same hardware, the best way is to simply copy the data out to an external drive or some other storage, then install Amahi fresh and copy the data to it, via USB or network.
If you are using different hardware, the best way to do this is by installing Amahi then copying the data over the network.
» Why do I need to register?
» Do you support Fedora 14?
» I cannot login!
There are two main username systems related to Amahi:
- The user (or email) in amahi.org and it's password. This is reset via email. This username is not case sensitive, though the password IS case sensitive
- The user in your server and its password. Fedora asks you to make one user during install and after that, that same username is used to fully create the first user in Amahi. These usernames and passwords are case sensitive.
These are two different systems. Your server is your server and cannot be reset by anyone but you, being logged in.
What you say can be interpreted as saying that one does not allow you to get into the other, which is right.
» How do I get Amahi Credit
» Do you support Fedora 15?
» When I subscribe to Amahi plans or buy apps, where does the money go?
- One of the main priorities is to make Amahi self-sustained. We have mostly reached that stage, where we can pay our bills every month.
- Another priority is provide enough value to be able to hire the Amahi team full-time.
- Other priorities are to foster open source apps and support worthy projects and organizations aligned with Amahi's goals.
» How do I do an email change?
» How do I change my password?
» Is using an SSD for Amahi beneficial?
Generally, Amahi is meant to be long running. In that sense, it's power efficient to be in SSD. However, having only one SSD drive is not that efficient if a bunch of other disks are also spinning in the system. They have to be power-managed for the system to be efficient. If the other drives are green and power-managed so that they are efficient, then an SSD will play well.
The second point is speed. Generally, booting will be much faster with an SSD OS disk. Hower there will be limited benefit from SSD if you have enough memory to hold Amahi and the OS. Since Amahi and Linux is meant to have a fairly small memory footprint, this is not a high bar. Since Amahi is not meant to be rebooted often, having an SSD is of limited value for making a speedy boot.
Overall, it's nice to have SSD if you can afford it. It will become more and more affordable over time, so it's clearly the future!
» Can I change my nickname?
» Is Amahi Credit refundable?
» Does Amahi support ZFS?
Configuration
» Do I really need the HDA to be in a static IP address?
» Can I use a domain that does not exist in the internet for my home network?
» What happens if I pick a domain that already exists in the internet?
» Can I use a top-level domain?
» What home domain should I pick in my HDA configuration?
- Don't use a dynamic DNS domain. These are really for use externally, not in your home network! (besides, you get a free, zero-configuration dynamic DNS address externally with your Amahi HDA install)
- Don't use the same domain you get your email at*.
- Don't use a long domain. Shorter makes your networking simpler.
- Do feel free to use a vanity domain or one that does not exist on the Internet at large
home.com for your home DNS domain. That means your machines at home will be part of this DNS domain.
For instance, if you have an iPhone and a vaio computer, they will come up as
iphone.home.com and vaio.home.com.
Note that this choice has no bearing with things as seen from the outside of your home network.
From inside, you will "own" that domain in your network and will not be able to see anything from that domain outside of your network. So we recommend you choose a domain that you
- Don't care about seeing it from your network*, and/or
- Does not exist
» What static IP address should I chose for my HDA?
10 but anything up to 99 should do.
We do not recommend using IPs 100 and above because that's the range that the HDA uses to give out dynamic DHCP leases. We may change this in the future to make it more flexible.
» What are my Network Gateway Settings?
- 192.168.1.1
- 192.168.0.1
- 192.168.1.1
- 192.168.0.254
- 10.10.10.10
ipconfig /all
In Mac OS X, go to System Preferences, Network, and look in the Router field.
In Linux, we don't have to tell you :-)
route
and look at the Gateway column for the default route.
» Can I change my home domain once my HDA is installed?
Installation
» The installer recommends having a swap partition. What should I do?
» Does Amahi support LVM?
» hda-install: command not found - what gives?
» Do I need to change how my HDA is plugged into the router?
» Can I set up Amahi to boot headless?
» Update for new HDA Apps (or no apps available)
yum -y install 'hda-app*'
» Can Amahi be setup as a VMware appliance?
Yes -- Amahi has been setup to run on VMware, though we do not make a pre-built VMware appliance 'image' available at the moment.
Many people also use VirtualBox and Virtual PC to play with Amahi before running their server on real hardware.
» HDA specific URLs are not working
service httpd restart
» I am using a proxy, however I cannot retrieve the repository RPMs
rpm or yum to install the Amahi Linux Home Server and you are behind a proxy, you may need to set the proxy specifically for those programs.
- For
rpm, you will need to use the options--httpproxy HOSTand maybe--httpport PORT - For
yum, you may have to doexport http_proxy=HOST:PORTin/etc/yum.confor from the command line before usingyumby hand. See this article to learn more aboutyumand proxy servers.
» Is it best to allow the system to update before setting up my HDA or should I setup first?
» I see a problem with 'yum lock' being present when I try to install, help!
killall -HUP yum-updatesd
If that does not work, the big hammer approach may:
killall -KILL yum-updatesd
» Do you support 64-bit systems?
» Do I need a client for the Amahi dynamic DNS?
» Does Amahi support installing on the secondary network adapter? (eth1)
» I can't sign on into my HDA!
» The applications do not work! It takes me to home.com!?
When the applications are installed, most of them also install a DNS name, which we usually call a "short name", like http://blog, also aliased to your full domain, like blog.home.com.
If you click on one app link and it does not work, most likely, your client is not using your HDA for DNS.
To do that, you can force your client to use your HDA for DNS, or, more easily, you can turn off your router's DHCP server and then restart your clients.
You can also release and renew the lease if your client if you know how do do that. In Windows, you type in a command window: ipconfig /release then ipconfig /renew.
Apps
» Do you charge for apps?
» Does the one-click fee for apps get shared with the app contributors?
» Does the one-click fee for apps get shared with the app authors?
» If I pay the one-click fee for an app, do I have to pay for it app again?
» What about reinstalls and updates to one-click fee apps?
» Can I test a one-click install fee app?
» If I cannot use the app, can it be refunded?
» How quickly will Amahi release app security updates?
Usage - general
» I've successfully completed the hda-install. How do I get started?
» Why is mt-daapd fail to start when my HDA boots?
» Can I host my own web site with Amahi?
Yes! This is an advanced feature that technical users love.
Generally, there are a lot of security issues one has to deal with if you want to host your own apps. Amahi cannot possibly help with that beyond warning about that.
At any rate, you can see how to host a web site in our wiki.
Usage - networking
» Can I have the HDA give static IPs for specific machines?
» Didn't I use //hda from my Windows window to open the files in my HDA??
» I want to add a printer to my HDA and make it a printer server, how do I do it?
» Can I disable the DHCP server in my Amahi HDA?
- First go to the Setup --> Settings --> Servers
- Once there, find the DHCP and unselect both "Watchdog. DHCP Server is being monitored 24x7" and "Start at Boot time"
- Then Stop DHCP
Here are the tradeoffs if you would like to only use some of the functionality. In short, a few of the nicer features of your HDA will not be available. You can still point your machines to the DNS server in the HDA and get some of the benefits, like nice URLs for your HDA-provided services. This is not a supported configuration for things like Amahi Netboot.
» How do I setup port forwarding in my router?
» My computers disappear from "My network places" after 10-20 minutes!
» Does Amahi work under a VLAN environment?
Usage - file sharing
» How do I configure file sharing for windows/mac machines in my network?
» The Samba configuration utility is not installed
yum install system-config-samba
This command should be run as root (directly or with sudo).
» Do i have to use a prefix on the username to log in to my HDA?
» Do the Amahi shares have quotas?
» If I change where a share is, does the content get moved or stay where it is?
A share is a pointer. Shares provide access to data.
Adding, moving or deleting a share does not touch data at all.
» Is it possible to map a network drive for a hidden folder?
» What transfer speeds should I expect?
- Type of network (10/100/1000 wired, wireless, etc.)
- speed of the drives involved
- client OS used
- cables used (cat4, cat5, cat6)
- switches or hubs used
- chipset used by the clients and the server
Usage - VPN
» When the VPN client asks for users what users are those?
Amahi Sync
» What is Amahi Sync?
» Where is Amahi Sync storage hosted?
» How secure is Amahi Sync?
Public share. By definition this lets you get public links to those files, even though the files are unlisted. The only way for someone to access these files are that a) you give them a link to it or b) someone guesses the link to the file.
Files from different users have different locations and are separated by DNS-based names, each in a virtual host belonging to each user. This helps in separating user areas, because one area is not reachable from another.
Running your HDA
» Login as "root"
- With direct access to the console, simply choose the username
root - If you are already logged in as another user enter
su -to change the current session to the root user - Use PuTTY or a similar utility to remotely login to the HDA
» Set up VNC
- Setup VNC server on the HDA
- Set the VNC user's access password
- Start the VNC service on the HDA
- Access the machine using VNC viewer
» How do I update my Amahi HDA?
- Amahi updates are automatic. Major security updates from the base distribution will also be made available for automatic updates, however, you should always apply security updates if the system prompts you for them
- Fedora updates are not enabled automatically. This is for stability reasons. We don't discourage users from updating. You can do Fedora updates by using the tools that come up on the screen, or you can update by hand via the command line, with
yum update.
This seems to work well and we received good feedback on it, users like it. However, we may change this in the future based on feedback.
We do try to make sure we keep reasonably up to date with the upstream distribution to make sure updates do not break anything in Amahi, however, that's something of a race, so if you update and notice something strange with Amahi, please report it (file a bug, or in the forums), indicating that you updated.