Main Page

This is the knowledge base wiki for Amahi the home server. Please add or edit any information in this Wiki that you feel is lacking, missing, or needs improvement.

• Introduction to the Amahi HDA, or Home Digital Assistant, "like a PDA, but for the home"
• Minimum System requirements
• Frequently Asked Questions (FAQ)
• Interactive Network Troubleshooter
• Issues and feedback
• Have a look at the Popular Pages to see if your topic of interest is there. Otherwise find the major topics below in groups.

---

NOTES:

1. Current stable release: Amahi 7, Fedora 19
2. Amahi one-click applications are typically updated for the latest stable release ONLY.
3. This wiki is built to provide support for the stable releases of Ubuntu 12.04.x and Fedora 19.
4. Registration in this wiki is subject to manual approval due to spam considerations.

---

Installation

• Instructions:
  • Fedora 19 / Amahi 7 (officially supported release)
    • Express CD (64-bit): Headless (all-in-one). ONLY supported Amahi 7 installation media.
    • Alternate media (NOT fully supported):
      1. Full DVD (32/64-bit): May help with hardware capability issues.
      2. USB Live CD (32/64-bit): Useful for those without CD/DVD drives.
  • Ubuntu 12.04.x LTS (maintenance support ONLY)
  • Fedora 14 (maintenance support ONLY)
  • Amahi Virtualized (NOT fully supported)

• Troubleshooting:
  • Fedora 19 (Express 64-bit CD/DVD)
  • Ubuntu 12.04.x (CD)

Post-Installation

• Terminal Scripts: Useful command line scripts.
• Linux/HDA Commands: Commonly used commands for Linux and Amahi.
• Storage and file sharing: Setup & manage users and shares and access between them.
• Access Shares using:
  • Windows: Setup (map) access to your shares in Windows (XP thru 8).
  • Mac OS X: Setup access to your shares in MAC OS X.
  • Linux Systems: Setup access to your shares in other Linux systems.
• Troubleshooting Shares: troubleshoot shares.
• Post Install Hardware Changes: Steps for changing hardware on your Amahi server (i.e. mother board, network card, etc).
• Adding a second hard drive to your HDA Adding additional hard drives

Remote Access

Accessing your HDA from anywhere on the network

• Virtual Private Networking (VPN): Access from outside your network.
• Secure Shell (SSH): Key-based access to your HDA.
• Virtual Network Computing (VNC): Access from inside your network (e.g. if your HDA is "headless").
  • Ubuntu
  • Fedora

Greyhole (Storage Drive Pooling)

Redundant Storage Pooling for your files

• Greyhole: Overview of Greyhole with Amahi.
• Greyhole Wiki: External Greyhole Wiki site.
• Storage Pooling: Overview of what it is all about.
• Greyhole Logmon: Amahi application for your HDA that monitors Greyhole activity.
• Mounting Shares Locally: How to mount shares locally on the HDA for managing data safely.
• Greyhole landing zone (LZ): Explained and how to work with it.
• Updating Greyhole: Manual update option for Greyhole on Amahi 6 (Ubuntu) ONLY.
• Moving Data Out of Greyhole: Removing drives and data out of the storage pool.
• Amahi 7 Create Manual Greyhole Setup: How to manually install and configure Greyhole.

Networking

Using your HDA to manage your home network

Local Area Network (LAN): Internal networking

• Networking - Static IPs: How to assign static IPs to your network devices.
• Change IP Address/Network Gateway/DHCP Server Range: Change IP address of your Amahi server, Network Gateway, and DHCP Server Range.
• Turning off DHCP Server: Shows how to turn off DHCP Server on your HDA.
• Use two HDAs on the same network: Guidance for a dual-HDA setup on a single network.
• Adding an HDA networked printer: Guide to set up a print server on your HDA.

Winde Area Network (WAN): External networking

• Punching DNS Holes: How to assign IP addresses outside of your network for your home domain.
• Hosting a web site: Display your own web site on the internet from your Amahi home server
• Changing DNS provider: Change from OpenDNS to your Internet Service Provicer (ISP) or other third party provider.
• Configuring OpenDNS: Configure OpenDNS to filter or block web sites.

Additional Functionality

• Creating web apps: how to make your own web apps, with your code or other's code
• Apps Gallery: The repo of Amahi one-click applications (NOTE: Convenience fees may apply; log into Amahi website to purchase).
• Calendars: How to use the calendar server in the HDA, including Outlook and iCal sync.
• Backups: How to backup/restore Windows XP, Windows Vista/7/8, Ubuntu Linux, and Mac OS X.
• RAID: Configuration guides for RAID 1 and RAID 5.
• Automatic Database Backup: Automated daily backup of HDA databases.
• Monit Web Interface: Amahi application to monitor and control status of your HDA services.
• Password protect Applications: Provides password protect for your Amahi installed applications.

Troubleshooting

• Network
• Greyhole
• Shares
• VPN
• File system

Community Tutorials

Contributed by the Amahi user community

• Ubuntu
• Fedora
• Applications

Roadmap & Development

The core team ONLY supports Ubuntu and Fedora development at this time. All others are being supported by the user community.

ACTIVE - Stable Released or In Development

• Fedora 19
• Ubuntu 12.04.x LTS (Maintenance support ONLY)
• Fedora 14 (Maintenance support ONLY)

INACTIVE - Unsupported or Halted

• Fedora 15 / 16 / 17 / 18 / 20
• Ubuntu 12.10 or newer
• CentOS 5 and 6
• Scientific Linux 6.1

Contribute

How you can help

• Translate Amahi to your language
• How to Create a new Theme
• Submit a Bug/Feature/Support report
• Package or Test apps
• Amahi Wallpapers
• Amahi Banners

Related Links

• Developers: How to write HDA apps, questions, API suggestions, etc.
• Credits: How are we doing all this? We have many OSS projects to thank!